> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.
# StateSet Commerce Network API
> Enterprise blockchain infrastructure for instant global commerce with native stablecoins
**New to StateSet?** Start with our [Quick Start Guide](#quick-start) to make your first API call in under 5 minutes.
# StateSet Commerce Network: The Operating System for Global Commerce
## 🚀 Why StateSet?
StateSet Commerce Network is the blockchain infrastructure that makes global commerce instant, programmable, and accessible. We're building the financial rails for the \$100+ trillion global economy.
Sub-second transaction finality with 10,000+ TPS capacity
ssUSD and USDC built-in, no bridging or wrapping needed
SOC2 Type II compliant with built-in KYC/AML and audit trails
## 📊 By the Numbers
\$5B+
Total Value Processed
\< 1 sec
Transaction Finality
\$0.01
Average Transaction Cost
99.99%
Network Uptime
## 🏗️ What Can You Build?
### Global Payment Processing
* Accept stablecoins from customers worldwide
* Instant settlement to your account
* Automated currency conversion
* Built-in fraud protection
```javascript theme={null}
// Accept payment in 3 lines
const payment = await stateset.payments.create({
amount: 100.00,
currency: 'ssusd',
customer: 'cust_123'
});
```
### Decentralized Finance
* Liquidity pools with automated market making
* Yield farming and staking rewards
* Collateralized lending protocols
* Synthetic asset creation
```javascript theme={null}
// Create a liquidity pool
const pool = await stateset.pools.create({
tokenA: 'ssusd',
tokenB: 'atom',
initialLiquidity: 10000
});
```
### Supply Chain Finance
* Invoice factoring with instant funding
* Purchase order financing
* Letter of credit automation
* Real-time settlement
```javascript theme={null}
// Factor an invoice
const factoring = await stateset.invoices.factor({
invoiceId: 'inv_123',
discount: 2.5,
immediate: true
});
```
### Autonomous Commerce
* Deploy AI agents with spending limits
* Automated procurement and payments
* Smart contract execution
* Multi-signature controls
```javascript theme={null}
// Deploy an AI agent
const agent = await stateset.agents.create({
name: 'ProcurementBot',
spendingLimit: 10000,
permissions: ['purchase', 'negotiate']
});
```
## 🚀 Quick Start
Get up and running with StateSet in minutes:
Choose your preferred language:
```bash npm theme={null}
npm install @stateset/sdk
```
```bash yarn theme={null}
yarn add @stateset/sdk
```
```bash pip theme={null}
pip install stateset
```
```bash go theme={null}
go get github.com/stateset/stateset-go
```
1. Sign up at [dashboard.stateset.com](https://dashboard.stateset.com)
2. Complete KYC verification (takes \< 5 minutes)
3. Generate your API keys
Keep your secret key secure and never expose it in client-side code!
```javascript theme={null}
import { StateSet } from '@stateset/sdk';
// Initialize the client
const stateset = new StateSet({
apiKey: 'sk_test_...'
});
// Check your balance
const balance = await stateset.account.balance();
console.log(`Balance: ${balance.ssusd} ssUSD`);
// Send a payment
const payment = await stateset.payments.send({
to: 'stateset1abc...',
amount: 100.00,
currency: 'ssusd',
memo: 'First payment!'
});
```
## 📚 Core APIs
Issue, redeem, and transfer ssUSD with full GENIUS Act compliance
Process payments, handle refunds, and manage payment methods
Create and manage e-commerce orders with automated fulfillment
Generate, send, and collect on invoices with instant settlement
Access trade finance, factoring, and lending protocols
Deploy and manage autonomous AI agents for commerce
## 🔐 Authentication
All API requests require authentication using API keys:
```bash theme={null}
curl https://api.stateset.com/v1/account/balance \
-H "Authorization: Bearer sk_test_..."
```
Use test mode keys (prefixed with `sk_test_`) for development and live mode keys (prefixed with `sk_live_`) for production.
## 🌐 Network Architecture
### Production Network
* **Chain ID**: `stateset-1`
* **RPC**: `https://rpc.stateset.com`
* **API**: `https://api.stateset.com`
* **Explorer**: `https://explorer.stateset.com`
* **Status**: [status.stateset.com](https://status.stateset.com)
### Test Network
* **Chain ID**: `stateset-testnet-1`
* **RPC**: `https://rpc-testnet.stateset.com`
* **API**: `https://api-testnet.stateset.com`
* **Explorer**: `https://explorer-testnet.stateset.com`
* **Faucet**: [faucet.stateset.com](https://faucet.stateset.com)
## 💡 Best Practices
* Never expose API keys in client-side code
* Use webhook signatures to verify events
* Implement idempotency keys for critical operations
* Enable 2FA on your dashboard account
* Use pagination for large result sets
* Implement exponential backoff for retries
* Cache frequently accessed data
* Use webhooks instead of polling
* Always check the `error` field in responses
* Log all errors with request IDs for debugging
* Implement proper retry logic for transient errors
* Monitor your rate limits
## 🆘 Need Help?
Comprehensive guides and API references
Chat with developers and get instant help
Priority support for enterprise customers
## 🚀 Ready to Build?
Sign up for a free account and get \$100 in test credits