streamflow

Crates.iostreamflow
lib.rsstreamflow
version0.1.1
sourcesrc
created_at2021-06-11 11:08:54.783886
updated_at2021-06-11 11:08:54.783886
descriptionSolana program for streamflow.finance
homepagehttps://streamflow.finance
repositoryhttps://github.com/streamflow-finance/streamflow-program
max_upload_size
id408957
size76,310
(parazyd)

documentation

README

StreamFlow

This repository contains the Solana program source code.

It is laid out as a standard crate, and the program code can be found in src/lib.rs.

Build and tests

Deployment

  • On Solana Mainnet, the program is not yet deployed.

  • On Solana Devnet, the program ID is: 2DvvSEde36Ch3B52g9hKWDYbfmJimLpJwVBV9Cknypi4

Usage

See cli/strfi.js to get an understanding.

initialize_stream

This instruction is used to initialize the stream, and save the data and lock the funds for streaming on a given account.

Note that the implementation sends DEFAULT_TARGET_LAMPORTS_PER_SIGNATURE immetiately to the recipient, so they don't have to have previous funds in order to issue a withdraw instruction in the future.

  • Accounts:

    • Alice (Sender) (signer, writable)
    • Bob (Recipient) (writable)
    • PDA (Account where funds will be locked) (signer, writable)
    • Solana System Program
  • Instruction data:

    • instruction (1 byte, u8) (Should be 0 for initialize_stream
    • start_time (32 bytes, u32) (Unix timestamp when funds start to be unlocked)
    • end_time (32 bytes, u32) (Unix timestamp when all funds should be unlocked)
    • amount (64 bytes, u64) (Amount of lamports to lock and stream)
  • Data saved in the PDA account:

    • start_time (64 bytes, u64)

    • end_time (64 bytes, u64)

    • amount (64 bytes, u64)

    • withdrawn (64 bytes, u64) (Amount that has been withdrawn so far)

    • sender (32 bytes, u8 array) (Alice/Sender's public key)

    • recipient (32 bytes, u8 array) (Bob/Recipient's public key)

withdraw_unlocked

This instruction is used by the stream recipient, and will transfer a given amount of lamports, if unlocked, from the stream account to the caller.

If the requested amount if lamports is 0 (zero), then all unlocked funds will be withdrawn.

  • Accounts:

    • Bob (Recipient) (signer, writable)
    • PDA (Account where the funds are locked) (writable)
    • Rent collector (Hardcoded address where the remaining rent is sent after a successful stream) (writable)
  • Instruction data:

    • instruction (1 byte, u8) (Should be 1 for withdraw_unlocked)

    • amount (64 bytes, u64) (Amount of lamports to potentially withdraw)

cancel_stream

This instruction is used by the stream initializer, and will cancel the given stream, returning all locked funds to the caller and purging the account.

  • Accounts:

    • Alice (sender) (signer, writable)
    • Bob (recipient) (writable)
    • PDA (account where funds are locked) (writable)
  • Instruction data:

    • instruction (1 byte, u8) (Should be 2 for cancel_stream)

License

StreamFlow Rust code is licensed AGPL-3.

Commit count: 91

cargo fmt