Creating a Paymaster

​

Prerequisites

• A paid subscription (PRO, ULTRA, or ENTERPRISE)
• Access to the Developer Portal
• SOL to fund the paymaster

​

Creating a Paymaster

​

Step 1: Navigate to Paymasters

1. Log in to the Developer Portal
2. Select your project
3. Click Paymaster in the sidebar

​

Step 2: Create New Paymaster

1. Click Create Paymaster
2. Configure the settings (see below)
3. Click Create

​

Step 3: Configure Settings

​

Label (Optional)

• Default: Paymaster {first4}...{last4} of the public key
• Use descriptive names like production-mainnet or dev-testing
• Maximum 64 characters

​

Usage API Threshold

• Default: 1,000
• Minimum: 1
• Prevents excessive API usage

​

SOL Usage Threshold

• Default: 10 SOL (10,000,000,000 lamports)
• Minimum: 0.000000001 SOL
• Controls monthly spending

​

Single TX Limit

• Default: 0.1 SOL (100,000,000 lamports)
• Minimum: 0.000000001 SOL
• Prevents large individual transactions

​

Allow Other Instructions

• Default: false
• Set to true to sponsor any transaction type
• Use with caution (increases potential for abuse)

​

Step 4: Paymaster Created

• Public Key - The paymaster’s Solana address
• Label - Your configured display name
• Balance - Current SOL balance (starts at 0)

​

Funding Your Paymaster

​

Get the Address

1. Go to the Paymaster page
2. Find your paymaster in the list
3. Copy the Public Key (Solana address)

​

Send SOL

solana transfer <PAYMASTER_ADDRESS> <AMOUNT> --allow-unfunded-recipient

1. Open your Solana wallet (Phantom, Solflare, etc.)
2. Send SOL to the paymaster address
3. Wait for confirmation

​

Verify Balance

1. Return to the Developer Portal
2. View the paymaster’s balance
3. The balance updates after blockchain confirmation

​

Example Configuration

​

Development Paymaster

​

Production Paymaster

​

Using Your Paymaster

​

Get the Public Key

// The paymaster address is shown in the portal
const paymasterPubkey = 'YourPaymasterPublicKeyHere...';

​

Create Wallets with Paymaster

import { SwigApiClient } from '@swig-wallet/api';

const client = new SwigApiClient({
  apiKey: 'sk_your_api_key',
  portalUrl: 'https://dashboard.onswig.com',
});

const { data: wallet, error } = await client.wallet.create({
  policyId: 'your-policy-id',
  network: 'devnet',
  paymasterPubkey: 'YourPaymasterPublicKey',
});

​

Sponsor Transactions

import { createPaymasterClient } from '@swig-wallet/paymaster-classic';

const paymaster = createPaymasterClient({
  apiKey: 'sk_your_api_key',
  paymasterPubkey: 'YourPaymasterPublicKey',
  baseUrl: 'https://api.onswig.com',
  network: 'devnet',
});

// Create a sponsored transaction
const tx = await paymaster.createLegacyTransaction(
  [yourInstruction],
  [userKeypair]
);

// Sign and send (paymaster covers the fee)
const signature = await paymaster.signAndSend(tx);

​

Tier Limits

​

Multiple Paymasters

​

Different Environments

• dev-devnet - Development testing
• staging-devnet - Staging environment
• production-mainnet - Live application

​

Different Use Cases

• user-onboarding - New user transactions
• high-value-ops - Large transactions (higher limits)
• automated-tasks - Scheduled operations

​

Cost Tracking

• Separate paymasters per product/feature
• Easier to attribute costs
• Better usage visibility

​

Troubleshooting

​

”Subscription required” Error

1. Go to Billing in the sidebar
2. Upgrade to PRO or higher
3. Try creating the paymaster again

​

”Paymaster limit reached” Error

1. Check your current paymaster count
2. Delete unused paymasters
3. Or upgrade your subscription

​

Paymaster Balance is 0

1. Copy the paymaster’s public key
2. Send SOL to that address
3. Wait for blockchain confirmation

​

Next Steps

• Manage paymaster settings
• View transaction history
• Monitor usage and analytics