View demoGitHub
PaymentsWallet API v2

With Wallet API, you can distribute payments to hundreds or even millions of recipients with just a few lines of code.

API Wallets empower you to orchestrate complex financial operations with ease and security, opening the doors to applications that were previously impractical.

This is a demo application of developer-custodied server wallet payments tool using the new CDP Wallets v2. Users can sign in with their Web2 authentication - email (currently powered by Google or Github) and send funds to other users via their emails. All emails are backed by Coinbase Server Wallets running on Base Sepolia. Users who don’t have an existing wallet have one created on send, and they can login and claim their wallet later.

​
Acknowledgments

This project leverages the Gaslite Drop contract from Pop Punk LLC Gaslite for mass transfers.

Special thanks to HeimLabs for foundational work on the original Paymaker frontend and backend that informed this sample app.

​
Prerequisites

​
Getting Started

0. Deploy the Drop Contract

This application uses the Gaslite Drop smart contract for the batch transfers. The .env.example file contains the contract address for the Gaslite Drop contract deployed on the Base Sepolia testnet. If you want to deploy your own contract, you can clone the Gaslite Core, and deploy by calling:

cd gaslite-core
forge build
forge script script/GasliteDrop.s.sol \
  --rpc-url https://sepolia.base.org \
  --broadcast \
  --chain-id 84532

Note: you will need to have your Base Sepolia wallet private key in your env as PRIVATE_KEY

  1. Clone the repository:
git clone https://github.com/coinbase-samples/coinbase-samples/cdp-sdk-mass-payments-ts.git
cd cdp-sdk-mass-payments-ts
  1. Install dependencies:
bun install
  1. Set up your environment variables - You will need to do the following
  • Copy .env.example to .env.local
  • Get an API Key ID and Secret from Coinbase Developer Platform portal
  • Generate a WalletSecret from the CDP Portal Wallet Page
  • Navigate to the Node page on the CDP Portal to get a Base Sepolia RPC URL for BASE_SEPOLIA_NODE_URL
  • Generate a secret for NEXTAUTH_SECRET via:
openssl rand -base64 32
  • Generate a ClientId and Secret for either Sign in with Google or Sign in with Github (or both)

Set that output in the .env.local for JWT and CSRF token signing

  1. Start the local Postgres/Neon database:
bun run start-local-db
  1. Start the development server:
bun run dev

The application will be available at http://localhost:3000.