ssUSD FAQ & Troubleshooting
Find answers to common questions and solutions to typical issues when working with StateSet USD.❓ Frequently Asked Questions
General Questions
What is ssUSD?
What is ssUSD?
StateSet USD (ssUSD) is a fully-backed, regulatory-compliant stablecoin pegged 1:1 to the US Dollar. It’s a stablecoin issued under the GENIUS Act, featuring:
- 1:1 USD backing with audited reserves
- Monthly CPA attestations published on-chain
- Criminal penalties for reserve misreporting
- Instant settlement on StateSet Network
- Multi-chain support (Base, Solana, Cosmos)
- Full KYC/AML compliance
Is ssUSD safe?
Is ssUSD safe?
Yes, ssUSD has multiple safety layers:
- Regulatory Safety: Federal oversight by OCC
- Reserve Safety: 100% backed by US Dollars and T-Bills
- Legal Safety: Criminal penalties for misreporting
- Technical Safety: Audited smart contracts
- Operational Safety: Segregated customer assets
What can I do with ssUSD?
What can I do with ssUSD?
ssUSD Use Cases:
- Payments: Instant, low-cost transactions globally
- E-commerce: Accept payments without chargebacks
- Payroll: Pay employees instantly worldwide
- Treasury: Hold stable, liquid reserves
- Cross-border: Send money internationally
Technical Questions
Which blockchains support ssUSD?
Which blockchains support ssUSD?
Supported Chains:
- StateSet (Native): Instant, $0.01 fees
- Base: Coinbase’s L2, low fees
- Solana: High-speed DeFi
- Cosmos IBC: 50+ connected chains
- Ethereum (Coming Q2 2024)
- Polygon (Coming Q2 2024)
What are the transaction limits?
What are the transaction limits?
Limits by Account Type:
Request limit increase →
| Account Type | Daily | Monthly | Per Transaction |
|---|---|---|---|
| Basic | $10,000 | $50,000 | $5,000 |
| Verified | $100,000 | $500,000 | $50,000 |
| Premium | $1,000,000 | $10,000,000 | $500,000 |
| Business | Custom | Custom | Custom |
How fast are transfers?
How fast are transfers?
Transfer Speeds:
- On StateSet: < 1 second finality
- To Base: ~2 seconds
- To Solana: ~3 seconds
- Cross-chain: 1-5 minutes (via bridge)
- Bank redemption: T+1 business day
What are the fees?
What are the fees?
Fee Structure:
- Transfers on StateSet: $0.01 flat
- Cross-chain bridge: 0.1% (min 100)
- Issuance: 0% (no fees)
- Redemption: 0% (no fees)
- Inactive account: $0/month
Compliance Questions
Do I need KYC?
Do I need KYC?
KYC Requirements:
- Required for: Issuance, redemption, > $1,000 daily volume
- Not required for: Transfers between verified users < $1,000
- Process time: 5-10 minutes automated
- Documents needed: Government ID, proof of address
- Business accounts: Additional docs (formation, tax ID)
Which countries are supported?
Which countries are supported?
Supported Regions:✅ Fully Supported: USA, Canada, UK, EU, Singapore, Japan, Australia⚠️ Limited Support: China, India, Brazil (transfers only)❌ Not Supported: North Korea, Iran, Syria, Cuba, Russia (sanctioned)See full country list
Are transactions reported to tax authorities?
Are transactions reported to tax authorities?
🔧 Troubleshooting Guide
Common Errors
Error: Insufficient funds
Error: Insufficient funds
Problem: Transaction fails with insufficient funds errorSolutions:
- Check your balance including pending transactions:
- Ensure you’re accounting for fees ($0.01 per transaction)
- Check if funds are locked or vesting:
Error: Invalid address format
Error: Invalid address format
Problem: Address validation failsSolutions:
- Verify address format for the chain:
- StateSet:
stateset1...(45 chars) - Ethereum/Base:
0x...(42 chars) - Solana:
base58...(44 chars)
- StateSet:
- Use address validation:
- Check for typos or extra spaces
Error: KYC required
Error: KYC required
Problem: Transaction blocked due to KYC requirementsSolutions:
- Complete KYC verification:
- Check KYC status:
- For business accounts, ensure all beneficial owners are verified
Error: Rate limit exceeded
Error: Rate limit exceeded
Problem: Too many API requestsSolutions:
- Check rate limit headers:
- Implement exponential backoff:
- Use batch operations when possible
- Upgrade to higher tier for increased limits
Error: Compliance block
Error: Compliance block
Problem: Transaction blocked for compliance reasonsSolutions:
- Check transaction details for flags:
- Common causes:
- Sanctioned entity involvement
- Unusual transaction pattern
- Missing Travel Rule info (> $3,000)
- Exceeding velocity limits
- Contact compliance team:
- Email: [email protected]
- Include transaction ID and context
Integration Issues
Webhooks not receiving events
Webhooks not receiving events
Problem: Webhook endpoint not receiving eventsSolutions:
- Verify webhook signature:
- Check webhook status:
- Common issues:
- Firewall blocking StateSet IPs
- SSL certificate problems
- Timeout (must respond in 20s)
- Wrong content-type (expects JSON)
Balance not updating
Balance not updating
Problem: Balance appears incorrect or not updatingSolutions:
- Check if including pending transactions:
- Subscribe to real-time updates:
- Clear cache if using one
- Verify transaction actually completed on-chain
🎯 Best Practices
Security
API Key Management
- Never expose secret keys in client code
- Use environment variables
- Rotate keys regularly
- Use restricted keys with minimal permissions
Transaction Security
- Always verify recipient addresses
- Use idempotency keys for retries
- Implement transaction limits
- Monitor for unusual patterns
Performance
Optimize API Calls
- Use batch operations when possible
- Implement caching for read operations
- Use webhooks instead of polling
- Parallelize independent operations
Error Handling
- Implement proper retry logic
- Log all errors with context
- Have fallback mechanisms
- Monitor error rates
🆘 Getting Help
Support Channels
Discord
Real-time help from community and team
GitHub Issues
Report bugs and request features
Email Support
For sensitive or account-specific issues
Emergency Contacts
- Compliance Issues: [email protected]
- Security Issues: [email protected] (PGP available)
- API Emergencies: +1-888-STATESET (24/7)