Viewing Paymasters
Paymaster List
- Log in to the Developer Portal
- Select your organization
- Click Paymaster in the sidebar
- Label - Display name
- Address - Solana public key
- Balance - Current SOL balance
- Status - Active or closed
- Network - Mainnet or devnet
- Actions - Edit, view, delete
Paymaster Details
Click a paymaster to view:- Full configuration
- Balance history
- Usage statistics
- Transaction history
Editing Settings
Accessing Edit
- Find the paymaster in the list
- Click Edit or the settings icon
- Modify the settings
- Click Save
Editable Settings
Label
Update the display name:- Descriptive and clear
- Maximum 64 characters
- Example:
production-mainnet-v2
Usage API Threshold
Adjust API call limits:- Increase for higher usage
- Decrease to reduce exposure
- Minimum: 1
SOL Usage Threshold
Modify monthly SOL spending limit:- Set based on expected usage
- Consider adding buffer
- Minimum: 0.000000001 SOL
Single TX Limit
Change per-transaction limit:- Balance security vs. functionality
- Higher for DeFi operations
- Lower for simple transfers
Allow Other Instructions
Toggle non-Swig instruction sponsorship:false- Only Swig instructions (recommended)true- Any instruction (use carefully)
Monitoring Balance
Current Balance
View the paymaster’s SOL balance:- Displayed in SOL
- Updates from blockchain
- Refresh to get latest
Balance Alerts
For Enterprise accounts:- Set a low balance threshold
- Configure alert recipients
- Receive notifications when balance drops
Funding
When balance is low:- Copy the paymaster address
- Send SOL from any wallet
- Balance updates after confirmation
Usage Monitoring
Current Period Usage
View usage for the current billing period:- API calls made
- SOL spent
- USD value sponsored
- Transactions count
Usage Limits
Track progress toward limits:- Progress bars show percentage used
- Warnings at 80% and 90%
- Critical at 100%
Usage Reset
Usage resets at the start of each billing period:- Monthly reset
- Counters go back to zero
- Limits restored
Limit Management
Understanding Limits
| Limit Type | Scope | Reset |
|---|---|---|
| Usage API Threshold | Per paymaster | Monthly |
| SOL Usage Threshold | Per paymaster | Monthly |
| Single TX Limit | Per transaction | N/A |
| Subscription Limit | Per organization | Monthly |
Adjusting Limits
When to increase limits:- Legitimate usage growth
- New product launch
- Seasonal traffic increase
- Security concern
- Cost control
- Usage normalization
Limit Hierarchy
Transactions are checked against:- Single TX limit (per paymaster)
- SOL usage threshold (per paymaster)
- Subscription limit (organization-wide)
Closing a Paymaster
When to Close
- No longer needed
- Consolidating paymasters
- Environment cleanup
Close Process
- Find the paymaster in the list
- Click Close or the close icon
- Enter a destination address for remaining funds
- Confirm the closure
What Happens
- Paymaster marked as deleted
- Remaining SOL transferred to destination
- Transaction history preserved
- Cannot be reactivated
Deleting a Paymaster
Permanent Deletion
After closing, you can permanently delete:- Find the closed paymaster
- Click Delete
- Confirm deletion
Network Selection
Switching Networks
View paymasters by network:- Click the Network Toggle
- Select Mainnet or Devnet
- View paymasters for that network
Network-Specific Paymasters
Create separate paymasters for:- Devnet - Testing and development
- Mainnet - Production applications
Best Practices
Regular Monitoring
- Check balances weekly (or daily for high-volume)
- Review usage trends
- Identify anomalies early
Conservative Limits
Start with conservative limits:- Easier to increase than decrease
- Limits exposure if issues occur
- Adjust based on data
Documentation
Keep records of:- Paymaster purpose
- Expected usage
- Configuration rationale
Alerting
Set up alerts for:- Low balance (Enterprise)
- High usage
- Failed transactions
Troubleshooting
Transaction Failures
If transactions fail:- Check paymaster balance
- Verify limits aren’t exceeded
- Confirm paymaster is active
- Check transaction details in history
Balance Not Updating
If balance doesn’t update:- Wait for blockchain confirmation
- Refresh the page
- Check if transfer succeeded on explorer
Cannot Edit Paymaster
Possible causes:- Paymaster is closed
- Insufficient permissions
- API error (try again)
Enterprise Features
Low Balance Alerts
Configure alerts:- Set threshold (in lamports)
- Add recipient emails
- Alerts sent with 24-hour cooldown
Custom Limits
Enterprise accounts can request:- Custom monthly limits
- Custom per-transaction limits
- Priority processing
Dedicated Support
Enterprise accounts get:- Dedicated support contact
- Faster response times
- Custom configuration help
Next Steps
- View transaction history for detailed analytics
- Create more paymasters for different use cases
- Manage subscriptions for higher limits