Skip to content

web-payments/fund

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Funding Tools

Funding software development should be easier. This project contains a suite of software tools to help make it easier to donate funds to a variety of open source software developers and organizations.

How it Works

The simplest way to understand how this software suite works is to check out a few examples.

To donate $5 to the Apache Software Foundation:

> donate 5 apache

To donate $5 to a person with an e-mail address:

> donate 5 [email protected]

To donate to a project that has a git repository:

> git clone [email protected]:project/example.git
> cd example
> donate 5

The DONATE file format

The examples above are powered by a file format that lists how the donation should be processed. The file format is pretty simple, having one or more entries that follow the format below:

payment_method details

Valid values are:

payment_method := 'payswarm' | 'url' | 'bitcoin'
details := url | percentage WHITESPACE url
percentage := integer or decimal number
url := any valid URL (technically, any valid IRI)
WHITESPACE := \t | ' '

All percentages for the same payment type should add up to 100. Any line that does not match the pattern above is ignored, which means that a DONATE file can also be used to explain what the funds are typically used for.

PaySwarm Donations

If you are using PaySwarm, entries look like the following:

payswarm 70 https://meritora.com/i/joe-example/accounts/open-source
payswarm 30 https://meritora.com/i/bob-example/accounts/donations

Bitcoin Donations (future)

To donate to bitcoin addresses, you could do the following:

bitcoin 100 1PC9aZC4hNX2rmmrt7uHTfYAS3hRbph4UN

URL Donations (future)

If you are using a proprietary web-based payment solution, you can request that a web browser is opened to a particular URL. For example, the following would perform a PayPal donation:

url https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=ABCDEFG1234567

Invoicing (future)

Creating and sending out invoices is annoying and time consuming. This tool will allow you to invoice a customer from the command line through a website that you control.

invoice xyzcorp 8515.24

About

Command-line tools to fund to software development.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published