Full lesson

peer-pay

Fiat-to-Solana payment connector using Stripe. 2nd place, CoinW x Superteam UAE side track, Solana Renaissance Hackathon 2024.

What it does

From the project README:

Fiat payment connector to Solana that allows user to interact with Web3 protocols and on chain programs by paying with modern payment systems such as Stripe.

Original

e-mk/peer-pay

SuperStack fork

Blockchains/peer-pay @ ca496be

Stars

0

Last push (original)

2026-10-21

Languages

TypeScript, Rust, JavaScript, CSS

Detected stack

AnchorNext.js

Categories

Payments

Licence

Apache-2.0

Homepage

https://x.com/PeerPayOnSol

Architecture

35 source files. By extension: .ts ×12, .tsx ×11, .rs ×10, .js ×2.

On-chain programs: escrow/programs/mm_escrow

❌ Does not build as-is, checked 2026-11-02 Tested on 2026-11-02: full log results.json

Build it yourself: step-by-step guide

Every command below was run on 2026-11-02 by tests/run_fork.py against the pinned commit, and the results come from that run. The full output is in the committed log.

1. Prerequisites (versions we tested with)

• Rust: rustc 1.99.1 (58cf8f9c3 2026-10-13)
• Solana CLI (Agave): solana-cli 2.3.13 (src:5466f459; feat:2142755730, client:Agave)
• Anchor (via avm): 0.29.0
• Node.js: v24.22.1
• npm: 11.21.1
• pnpm: 10.34.6
• Go: go version go1.27.3 linux/amd64

cargo install --git https://github.com/coral-xyz/anchor avm --locked
avm install 0.29.0 && avm use 0.29.0
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

2. Clone at the tested commit

git clone https://github.com/Blockchains/peer-pay.git && cd peer-pay
git checkout ca496be4f2ee1ce5e4154922ec9a40c35029177b

3. Configure

The repo reads these environment variables. Copy the example file and fill in your own values. Never commit real keys.

• frontend/.env.example: NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, NEXT_PUBLIC_STRIPE_SECRET_KEY, NEXT_PUBLIC_HOST, NEXT_PUBLIC_SOLANA_PROGRAM_ID, NEXT_PUBLIC_SOLANA

4. Install dependencies

5. Build

note: to keep the current resolver, specify `workspace.resolver = "1"` in the workspace root's manifest
note: to use the edition 2021 resolver, specify `workspace.resolver = "2"` in the workspace root's manifest
note: for more details see https://doc.rust-lang.org/cargo/reference/resolver.html#resolver-versions
error: failed to parse lock file at: /tmp/scbuild/peer-pay/escrow/Cargo.lock
Caused by:
  lock file version 4 requires `-Znext-lockfile-bump`

> Build error occurred
Error: Failed to collect page data for /utils
    at /tmp/scbuild/peer-pay/frontend/node_modules/next/dist/build/utils.js:1258:15
    at process.processTicksAndRejections (node:internal/process/task_queues:104:5) {
  type: 'Error'
}

7. Deploy to a local validator

solana-test-validator --reset   # separate terminal
solana config set -ul && solana airdrop 100
anchor deploy --provider.cluster localnet

Deploy to devnet (free)

solana config set --url devnet
solana airdrop 2   # or https://faucet.solana.com
anchor deploy --provider.cluster devnet   # native: solana program deploy target/deploy/<name>.so
# point the frontend RPC env var at https://api.devnet.solana.com

How it works

Every instruction handler in the program, with the accounts struct it validates. Each link points to the line at the pinned commit.

Extend it

1. Add an integration test that runs the main flow end to end and asserts every account state change.
2. Add a negative test: call each instruction with the wrong signer or account and check that it fails.
3. Add an event (emit!) to each state-changing instruction and subscribe to it from the client.
4. Replace any unchecked AccountInfo with typed accounts plus has_one/seeds constraints.
5. Make the frontend read the cluster from an env var, deploy it to GitHub Pages and point it at your devnet program.
6. Wire the build into CI by copying this site's verify-forks workflow.

Key code, explained

Excerpts chosen automatically where the code uses the most Solana concepts, pinned to the fork's commit.

    seller: Signer<'info>,    x_mint: Account<'info, Mint>,    y_mint: Account<'info, Mint>,    #[account(mut,     constraint = sellers_x_token.mint == x_mint.key() &&     sellers_x_token.owner == seller.key())]    sellers_x_token: Account<'info, TokenAccount>,    #[account(        init,        payer = seller,        seeds = ["escrow".as_bytes(),         seller.key().as_ref(),         product_seed.as_str().as_bytes()],        space = Escrow::LEN,        bump,    )]    pub escrow: Account<'info, Escrow>,    #[account(        init,        payer = seller,        seeds = ["escrow".as_bytes(), escrow.key().as_ref()],        token::mint = x_mint,        token::authority = escrow,        bump,

pub use crate::state::*;use anchor_lang::prelude::*;use anchor_spl::token::{close_account, transfer, CloseAccount, Token, TokenAccount, Transfer}; #[derive(Accounts)]pub struct Cancel<'info> {    #[account(mut)]    seller: Signer<'info>,    #[account(      mut,       constraint = escrowed_x_tokens.key() == escrow.escrowed_x_tokens,      seeds = ["escrow".as_bytes(),       escrow.key().as_ref()],      bump    )]    pub escrowed_x_tokens: Account<'info, TokenAccount>,    #[account(        seeds = ["escrow".as_bytes(), escrow.authority.key().as_ref(), escrow.product_seed.as_str().as_bytes()],        bump,    )]    pub escrow: Account<'info, Escrow>,    #[account(mut,       constraint = sellers_x_token.mint == escrowed_x_tokens.mint && sellers_x_token.owner == seller.key())]    sellers_x_token: Account<'info, TokenAccount>,

use anchor_lang::prelude::*;use anchor_spl::token::{transfer, Token, TokenAccount, Transfer};use std::str::FromStr; use solana_program::sysvar::instructions::{    self, load_current_index_checked, load_instruction_at_checked,}; pub use crate::constants::*;pub use crate::error::Errors;pub use crate::helpers::helpers::check_price;pub use crate::state::*; #[derive(Accounts)]pub struct Accept<'info> {    #[account(mut)]    buyer: Signer<'info>,    #[account(        seeds = ["escrow".as_bytes(),         escrow.authority.key().as_ref(),         escrow.product_seed.as_str().as_bytes()],        bump,    )]    pub escrow: Account<'info, Escrow>,

How to run, build and test

These commands come from the repo's own manifests (package.json scripts, Anchor.toml, Cargo, go.mod, Makefile). Check the README for prerequisites and environment variables.

What you could build from it

• Fork the SuperStack copy and extend it within the Payments gaps listed on the idea page.
• Learn the pattern first: Solana Pay
• Learn the pattern first: SPL Tokens: mints, accounts and transfers
• Learn the pattern first: Blinks and Solana Actions

Used in lessons

• Escrow patterns