POST Token Whitepaper
Section 17
Appendices
Supplementary materials and technical references supporting the whitepaper. Includes glossary of terms, token specifications, technical architecture details, API references, and additional documentation.
Appendix Contents
Appendix A: Glossary of Terms
| Term | Definition |
|---|---|
| POST | Postal Token - The primary utility and governance token of POST Token with a total supply of 21 billion. |
| PSDR | Postal Special Drawing Rights - A stablecoin pegged to the IMF SDR, used for cross-border settlements between postal operators. |
| SDR | Special Drawing Rights - An international reserve asset created by the IMF, representing a basket of major currencies (USD, EUR, CNY, JPY, GBP). |
| UPU | Universal Postal Union - A specialized agency of the United Nations that coordinates postal policies among 192 member nations. |
| Terminal Dues | Payments made by the originating postal operator to the destination operator for delivering international mail. |
| PoT | Proof of Transfer - Cryptographic proof generated when an item is transferred between postal operators. |
| PoD | Proof of Delivery - Cryptographic proof generated when an item is successfully delivered to the recipient. |
| DPoS | Delegated Proof of Stake - Consensus mechanism where token holders vote for validators who secure the network. |
| Validator | A node operator (typically a postal operator) that participates in block production and network consensus. |
| Vesting | The process by which tokens become available to holders over time, preventing immediate selling pressure. |
| Airdrop | Distribution of tokens to eligible recipients, such as country allocations or user rewards. |
| TVL | Total Value Locked - The total value of assets deposited in DeFi protocols or liquidity pools. |
| LP | Liquidity Provider - Users who deposit assets into liquidity pools to enable trading. |
| AMM | Automated Market Maker - Smart contract-based trading mechanism that uses liquidity pools instead of order books. |
| KYC | Know Your Customer - Identity verification process required for financial services. |
| AML | Anti-Money Laundering - Regulations and procedures to prevent money laundering. |
Appendix B: Token Specifications
Basic Information
| Token Name | POST Token |
| Symbol | POST |
| Total Supply | 21,000,000,000 (21 billion) |
| Decimals | 18 |
| Type | CW-20 (Cosmos) |
Token Utility
- Network transaction fees
- Validator staking and delegation
- Governance voting rights
- POST→PSDR conversion gateway
- Liquidity provision rewards
- Premium service access
Token Allocation
| Category | Percentage | Amount | Vesting Schedule |
|---|---|---|---|
| Country Airdrops | 30% | 6.3B | 10 years linear |
| Network Development | 20% | 4.2B | 5 years linear |
| Ecosystem Growth | 15% | 3.15B | 4 years linear |
| Team & Advisors | 10% | 2.1B | 4 years with 1-year cliff |
| Strategic Partners | 10% | 2.1B | 3 years linear |
| Liquidity Provision | 5% | 1.05B | Immediate unlock |
| Community Rewards | 5% | 1.05B | Ongoing distribution |
| Reserve | 5% | 1.05B | Governance controlled |
Basic Information
| Token Name | Postal SDR |
| Symbol | PSDR |
| Peg | 1 PSDR = 1 IMF SDR (~$1.33) |
| Supply | Dynamic (transaction-backed) |
| Minting | Only via POST swap with valid transaction |
Key Rules
- Can ONLY be minted with a valid transaction_id
- Held ONLY by postal operators and UPU
- Users and merchants CANNOT hold PSDR
- Used exclusively for inter-operator settlements
- Collateralized by POST tokens + fiat reserves
Appendix C: Technical Architecture
Network Specifications
| Blockchain | Cosmos SDK-based sovereign chain |
| Consensus | Tendermint BFT (DPoS) |
| Block Time | ~6 seconds |
| Finality | Instant (single block) |
| TPS | 10,000+ transactions per second |
| Smart Contracts | CosmWasm (Rust-based) |
| Interoperability | IBC Protocol (Cosmos ecosystem) |
| Token Standard | CW-20 (fungible), CW-721 (NFT) |
| Validator Set | 192 active validators (one per UPU member) |
| Minimum Stake | 1M POST for validators |
Security Features
Multi-signature governance:
7-of-11 multisig for critical operationsHSM key management:
FIPS 140-2 Level 3 certifiedAudit trail:
Complete transaction history on-chainEmergency pause:
1-hour response capabilityBug bounty:
Up to $1M rewards for vulnerabilitiesInsurance:
$100M coverage for smart contract failures
Smart Contract Addresses (Mainnet)
POST Token: post1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq... PSDR Token: post1psdrrrrrrrrrrrrrrrrrrrrrrrrrrrrr... Gateway: post1gatewayyyyyyyyyyyyyyyyyyyyyyyy... Vesting: post1vestinggggggggggggggggggggggg... Governance: post1governanceeeeeeeeeeeeeeeeeee... Treasury: post1treasuryyyyyyyyyyyyyyyyyyyyyy...
Note: Full contract addresses will be published upon mainnet launch.
Appendix D: API Reference
The POST Token API provides RESTful endpoints for integrating with the network. Base URL: https://api.post.network/v1
| Endpoint | Method | Description |
|---|---|---|
/api/v1/transfer | POST | Initiate a cross-border transfer |
/api/v1/settlement | POST | Settle terminal dues between operators |
/api/v1/rate | GET | Get current POST/PSDR exchange rate |
/api/v1/balance/:address | GET | Get token balance for an address |
/api/v1/transaction/:id | GET | Get transaction status and details |
/api/v1/operator/:code | GET | Get postal operator information |
/api/v1/validate | POST | Validate a transaction for swap eligibility |
/api/v1/vesting/:country | GET | Get country vesting allocation status |
Example: Initiate Transfer
POST /api/v1/transfer
Content-Type: application/json
Authorization: Bearer <api_key>
{
"from_operator": "USPS",
"to_operator": "DEUTSCHE_POST",
"amount": "1000.00",
"currency": "PSDR",
"transaction_id": "PKG-2026-0001-ABC123",
"recipient": {
"name": "John Doe",
"address": "123 Main St, Berlin, Germany"
}
}Appendix E: Key Calculations
The SDR value is calculated based on a basket of five major currencies with the following weights (as of 2022 review):
| Currency | Weight | Amount per SDR |
|---|---|---|
| US Dollar (USD) | 43.38% | 0.57813 |
| Euro (EUR) | 29.31% | 0.37379 |
| Chinese Yuan (CNY) | 12.28% | 1.0993 |
| Japanese Yen (JPY) | 7.59% | 13.452 |
| British Pound (GBP) | 7.44% | 0.080870 |
SDR Value = Σ (Currency Amount × Exchange Rate)
Example (approximate):
1 SDR = (0.578 × 1.00) + (0.374 × 1.08) + (1.099 × 0.14) +
(13.45 × 0.0067) + (0.081 × 1.27)
≈ $1.33 USDEach country's allocation is calculated based on postal volume and population:
Country Allocation = Base Amount × (Volume Weight + Population Weight) Where: - Base Amount = 6.3B POST / 192 countries = 32.8M POST base - Volume Weight = (Country Postal Volume / Global Volume) × 0.6 - Population Weight = (Country Population / Global Population) × 0.4 Example (United States): - Base: 32.8M POST - Volume Weight: (40B items / 330B items) × 0.6 = 0.073 - Population Weight: (330M / 8B) × 0.4 = 0.0165 - Multiplier: 1 + 0.073 + 0.0165 = 1.0895 - Allocation: 32.8M × 1.0895 = 35.7M POST
| Transaction Type | Fee | Distribution |
|---|---|---|
| POST Transfer | 0.1% (min 0.01 POST) | 70% validators, 30% treasury |
| PSDR Settlement | 0.05% | 100% validators |
| POST→PSDR Swap | 0.3% | 50% validators, 50% treasury |
| Remittance (User) | 1.0% (capped at $10) | 60% operators, 40% network |
| Merchant Payment | 0.5% | 70% operators, 30% network |
Appendix F: References & Resources
Technology
Research & Compliance
POST Token Resources
Appendix K: Vesting Contract Specification
Complete technical specification for the Country Airdrop Vesting Contract, which enforces the Controlled Release Mechanism described in Section 5 (Tokenomics).
Contract Architecture
┌─────────────────────────────────────────────────────────────────┐ │ VESTING CONTROLLER │ ├─────────────────────────────────────────────────────────────────┤ │ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ │ │ │ COUNTRY │ │ VESTING │ │ NETWORK │ │ │ │ REGISTRY │ │ SCHEDULE │ │ LIMITS │ │ │ │ │ │ │ │ │ │ │ │ 192 entries │ │ 4-year │ │ Daily/Weekly │ │ │ │ Lock amounts │ │ Linear │ │ Monthly/Year │ │ │ │ Sold amounts │ │ 25%/year │ │ Global caps │ │ │ └───────────────┘ └───────────────┘ └───────────────┘ │ └─────────────────────────────────────────────────────────────────┘
Per-Country Limits
| Daily | 10,000 POST |
| Weekly | 50,000 POST |
| Monthly | 200,000 POST |
| Annual | 2,500,000 POST |
Network-Wide Limits
| Daily | 5,000,000 POST |
| Weekly | 25,000,000 POST |
| Monthly | 100,000,000 POST |
| Annual | 500,000,000 POST |
Each country receives 16,406,250 POST with the following breakdown:
| Allocation Type | Amount (POST) | Status |
|---|---|---|
| Validator Stake | 1,000,000 | Locked |
| Governance Minimum | 2,000,000 | Locked |
| Transaction Reserve | 3,000,000 | Operational Only |
| LP Minimum | 400,000 | Locked in Pool |
| Total Locked | 6,400,000 | |
| Sellable Amount | 10,006,250 | Subject to Vesting |
Execute Messages
SellVestedTokens- Sell vested POST (operator only)RegisterCountry- Register new country (admin)UpdateOperator- Update operator address (admin)EmergencyReset- Reset rate limits (governance)UpdateLimits- Update rate limit caps (governance)
Query Messages
GetConfig- Contract configurationGetCountryAllocation- Country detailsGetVestedAmount- Current vested amountGetAvailableToSell- Available within limitsGetNetworkLimits- Network-wide limitsSimulateSale- Check if sale would succeed
Linear vesting over 4 years (126,144,000 seconds):
Vested Amount = Sellable Amount × (Time Elapsed / Vesting Duration) Example (Year 2): - Sellable: 10,006,250 POST - Elapsed: 63,072,000 seconds (2 years) - Duration: 126,144,000 seconds (4 years) - Vested: 10,006,250 × (63,072,000 / 126,144,000) = 5,003,125 POST
Query Available Amount
// Query
{ "get_available_to_sell": { "country_code": "US" } }
// Response
{
"country_code": "US",
"vested_available": "2500000000000",
"daily_remaining": "10000000000",
"weekly_remaining": "35000000000",
"max_sellable_now": "10000000000"
}Execute Sale
// Execute
{ "sell_vested_tokens": { "amount": "10000000000" } }
// Response
{
"action": "sell_vested_tokens",
"country": "US",
"amount": "10000000000",
"total_sold": "50000000000",
"vested_remaining": "2450000000000"
}Note: Full Rust implementation code available in the POST Token GitHub repository under /contracts/vesting.
Document Information
Section
Appendices (A-F, K)
Version
1.1.0
Status
COMPLETE
Last Updated
February 3, 2026