Install the Pesa SDK

@pesa/sdk is in preview. Access is by request until it is published on npm. Write to the team through pesapay.xyz.

Install

npm install @pesa/sdk viem @stellar/stellar-sdk

pnpm add @pesa/sdk viem @stellar/stellar-sdk

yarn add @pesa/sdk viem @stellar/stellar-sdk

viem (2.x) and @stellar/stellar-sdk (16.x) are peer dependencies. The SDK uses them to decode and check EVM calls and Stellar transactions. Install exactly one copy of @stellar/stellar-sdk in your bundle: the Stellar verifiers use instanceof, which fails across two copies. The package is ESM only and runs in browsers, React Native and Node.

What is in it

Export	What it is
`createTransfersClient`	Typed client for every `/v1` endpoint
`TransfersApiError`	The error the client throws on a non-2xx reply
`CCTP_EVM_CHAINS`, `STELLAR_CCTP`, `findEvmChain`	The chain registry: CAIP-2 IDs, CCTP domains, contract addresses, sponsored and Fast Transfer flags
`verifyCctpCalls`, `verifySendToAddress`, `verifyStellarPayment`, …	Verifiers. See Verifiers
`toStellarUnits`, `fromStellarUnits`	6-decimal to 7-decimal USDC conversion
`encodeHookData`, `decodeHookData`, `buildCctpBurnCalls`	CCTP helpers
`sep24Status`, `TRANSITIONS`, `TERMINAL`, `CANCELLABLE`	Transfer state tables
Types	`QuoteRequest`, `QuoteResponse`, `Action`, `Submission`, `TransferView`, `RouteInfo`, `Stage`, `Sep24Status`

Create a client

import { createTransfersClient } from "@pesa/sdk";

const pesa = createTransfersClient({
  baseUrl: "https://api.pesapay.xyz",
  getToken: async () => myToken,   // SEP-10 JWT or Privy access token
  fetch: globalThis.fetch,         // optional
});

getToken is called before every authenticated request, so it can refresh a token on demand. See Authentication.

Start here

Pesa SDK

Integration guides

zkTLS SDK

Install the Pesa SDK

Install

What is in it

Create a client

​Install

​What is in it

​Create a client

Install

What is in it

Create a client