Crates.io | payment-program |
lib.rs | payment-program |
version | 0.1.7 |
source | src |
created_at | 2021-12-12 23:32:41.982359 |
updated_at | 2022-01-03 01:05:19.584881 |
description | Schedule one-time and recurring token transfers on Solana |
homepage | https://github.com/faktorfi/programs/tree/main/programs/payment |
repository | https://github.com/faktorfi/programs |
max_upload_size | |
id | 496752 |
size | 108,558 |
The Payment Program schedules one-time and recurring token transfers on Solana. It combines token account delegation and a bounty system to create a permissionless scheduled task queue capable of processing large batches of "transfer tasks" on a per-minute resolution.
This protocol offers two optimizations to current web3 "payments streaming" protocols:
Capital efficiency – By using delegated token transfers, senders do not have to lockup future payments in a vesting contract. Instead "drips" of tokens are sent every X minutes. This is beneficial in use-cases like subscription payments where senders want to "auto approve" the bill every month.
Time efficiency – The benefit to the recipient is they receive the tokens deposited directly into their wallet. These tokens are immediately spendable and do not need to be "claimed". This is important for use-cases like payroll where the recipients want to receive their income on a regular schedule.
# Cargo.toml
[dependencies]
payment-program = { version = "0.1.1", features = ["cpi"] }
The code snippets in this section are for Solana programs that need to schedule and manage on-chain payments. These examples assume the program has a singleton "program authority account" for signing instructions on behalf of the program.
This example instruction create_my_payment
displays a program creating a one-time payment. Since the program signs the create_payment
instruction with its authority account (a PDA), the authority account is marked the payment's owner – guaranteeing only the program may update it.
// create_my_payment.rs
use {
crate::state::*,
anchor_lang::{prelude::*, solana_program::system_program},
payment_program::{
cpi::{accounts::CreatePayment, create_payment},
program::payment_program,
state::Payment,
},
};
#[derive(Accounts)]
#[instruction(bump: u8)]
pub struct CreateMyPayment<'info> {
#[account(mut, seeds = [SEED_AUTHORITY], bump = authority.bump)]
pub authority: Account<'info, Authority>,
#[account(mut)]
pub payment: Account<'info, Payment>,
#[account(address = payment_program::ID)]
pub payment_program: Program<'info, PaymentProgram>,
#[account(mut)]
pub signer: Signer<'info>,
#[account(address = system_program::ID)]
pub system_program: Program<'info, System>,
}
pub fn handler(ctx: Context<CreateMyIndex>, bump: u8) -> ProgramResult {
// Get accounts.
let authority = &ctx.accounts.authority;
let payment = &ctx.accounts.payment;
let system_program = &ctx.accounts.system_program;
// TODO Create my payment.
}