@solobank/mpp-solana

Solana USDC payment method for the Machine Payments Protocol (MPP), built around Solana RPC plus SPL Token transfers.

Installation

pnpm add @solobank/mpp-solana mppx @solana/web3.js

Accept Payments

import { Mppx } from 'mppx';
import { solanaServer, SOLANA_USDC_MINT } from '@solobank/mpp-solana';

const mppx = Mppx.create({
  methods: [
    solanaServer({
      currency: SOLANA_USDC_MINT,
      recipient: 'YOUR_SOLANA_WALLET',
    }),
  ],
});

The server verifies the submitted Solana signature directly against RPC token balance deltas.

Make Payments

import { Connection, Keypair } from '@solana/web3.js';
import { Mppx } from 'mppx/client';
import { solanaClient } from '@solobank/mpp-solana';

const connection = new Connection('https://api.devnet.solana.com', 'confirmed');
const signer = Keypair.generate();

const mppx = Mppx.create({
  methods: [
    solanaClient({
      connection,
      signer: {
        publicKey: signer.publicKey,
        signTransaction: async (tx) => {
          tx.sign(signer);
          return tx;
        },
      },
    }),
  ],
});

The client:

loads all SPL token accounts for the requested mint
builds one or more transferChecked instructions
creates the recipient ATA if needed
signs and broadcasts the transaction
returns the Solana signature as the MPP credential

Exports

import {
  solanaClient,
  solanaServer,
  SOLANA_USDC_MINT,
  USDC_DECIMALS,
  parseAmountToRaw,
} from '@solobank/mpp-solana';

Testing

pnpm --filter @solobank/mpp-solana test
pnpm --filter @solobank/mpp-solana typecheck