@nirholas/bnbchain-mcp 1.0.0

package/build/sperax/resources.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Sperax MCP Server - Resources
+ *
+ * Protocol documentation and contract references as MCP resources
+ */
+export declare const PROTOCOL_OVERVIEW: string;
+export declare const USDS_DOCUMENTATION: string;
+export declare const STAKING_DOCUMENTATION: string;
+export declare const DEMETER_DOCUMENTATION: string;
+export declare const FORMULAS_DOCUMENTATION: string;
+export declare const VAULT_DOCUMENTATION = "# Sperax Vault System\n\n## Overview\n\nThe Vault is the core contract managing USDs collateral and yield strategies.\n\n## Architecture\n\n```\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502                   VAULT                      \u2502\n\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Collateral Pool                            \u2502\n\u2502  \u251C\u2500\u2500 USDC (~40%)                            \u2502\n\u2502  \u251C\u2500\u2500 USDT (~30%)                            \u2502\n\u2502  \u251C\u2500\u2500 DAI  (~20%)                            \u2502\n\u2502  \u2514\u2500\u2500 FRAX (~10%)                            \u2502\n\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Strategy Allocations                        \u2502\n\u2502  \u251C\u2500\u2500 Aave V3      \u2192 USDC, USDT              \u2502\n\u2502  \u251C\u2500\u2500 Compound V3  \u2192 USDC                    \u2502\n\u2502  \u251C\u2500\u2500 Stargate     \u2192 USDC, USDT              \u2502\n\u2502  \u2514\u2500\u2500 Curve        \u2192 3pool                   \u2502\n\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  Yield Distribution                          \u2502\n\u2502  \u251C\u2500\u2500 70% \u2192 USDs Holders (via Dripper)       \u2502\n\u2502  \u2514\u2500\u2500 30% \u2192 SPA Buyback & Burn               \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## Collateral Management\n\n### Supported Collaterals\n| Token | Min Allocation | Max Allocation | Oracle |\n|-------|---------------|----------------|--------|\n| USDC  | 30%           | 50%            | Chainlink |\n| USDT  | 20%           | 40%            | Chainlink |\n| DAI   | 10%           | 30%            | Chainlink |\n| FRAX  | 5%            | 20%            | Chainlink |\n\n### Minting Process\n1. User deposits collateral\n2. Vault receives collateral\n3. Oracle price fetched\n4. Mint fee deducted (0.1%)\n5. USDs minted to user\n6. Collateral deployed to strategies\n\n### Redemption Process\n1. User burns USDs\n2. Redemption fee deducted (0.2%)\n3. Collateral withdrawn from strategies (if needed)\n4. User receives collateral\n\n## Strategy Management\n\nStrategies are yield-generating contracts deployed on DeFi protocols.\n\n### Strategy Lifecycle\n1. **Proposal**: Governance proposes new strategy\n2. **Audit**: Strategy audited for security\n3. **Approval**: Governance votes to approve\n4. **Deployment**: Strategy deployed with allocation limits\n5. **Monitoring**: Continuous performance monitoring\n6. **Harvesting**: Yield collected regularly\n\n### Risk Parameters\n- Max allocation per strategy: 30%\n- Max allocation per protocol: 50%\n- Minimum diversity: 3 strategies active\n\n## Rebalancing\n\nVault automatically rebalances to maintain target allocations:\n\n```\nif (currentAllocation > targetAllocation + 5%) {\n  // Withdraw from over-allocated strategy\n  // Deploy to under-allocated strategy\n}\n```\n\n## Security Features\n\n- **Timelock**: All parameter changes delayed 48h\n- **Guardian**: Emergency pause capability\n- **Oracle redundancy**: Multiple price sources\n- **Circuit breakers**: Auto-pause on anomalies\n";
+export declare const YIELD_RESERVE_DOCUMENTATION: string;
+export declare const STRATEGIES_DOCUMENTATION = "# Sperax Yield Strategies\n\n## Overview\n\nSperax deploys collateral to battle-tested DeFi protocols to generate yield for USDs holders.\n\n## Active Strategies\n\n### 1. Aave V3 Strategy\n- **Protocol**: Aave V3 on Arbitrum\n- **Collaterals**: USDC, USDC.e, USDT\n- **Max Allocation**: 75%\n- **Risk Level**: Low\n- **Yield Source**: Variable lending rates\n\n### 2. Compound V3 Strategy\n- **Protocol**: Compound V3 on Arbitrum\n- **Collaterals**: USDC, USDC.e\n- **Max Allocation**: 75%\n- **Risk Level**: Low\n- **Yield Source**: Variable lending rates + COMP rewards\n\n### 3. Stargate Strategy\n- **Protocol**: Stargate Finance\n- **Collaterals**: USDC.e, USDT\n- **Max Allocation**: 50%\n- **Risk Level**: Medium\n- **Yield Source**: Cross-chain bridging fees + STG rewards\n\n### 4. Fluid Strategy\n- **Protocol**: Fluid (Instadapp)\n- **Collaterals**: USDC, USDC.e, USDT\n- **Max Allocation**: 75%\n- **Risk Level**: Low\n- **Yield Source**: Lending rates + protocol incentives\n\n## Strategy Interface\n\nAll strategies implement a common interface:\n\n```solidity\ninterface IStrategy {\n    function deposit(address token, uint256 amount) external;\n    function withdraw(address token, uint256 amount) external;\n    function checkBalance() external view returns (uint256);\n    function collectInterest() external returns (uint256);\n    function collectRewardTokens() external;\n}\n```\n\n## Allocation Management\n\n### Collateral Manager\nThe Collateral Manager controls how funds are allocated:\n\n- Sets allocation limits per strategy\n- Handles rebalancing between strategies\n- Enforces diversification requirements\n\n### Allocation Caps\n\n| Strategy | Max Allocation |\n|----------|---------------|\n| Aave V3 | 75% |\n| Compound V3 | 75% |\n| Stargate | 50% |\n| Fluid | 75% |\n\n## Yield Collection\n\n1. **Interest**: Automatically accrues in strategy\n2. **Rewards**: Harvested periodically (ARB, COMP, STG, etc.)\n3. **Collection**: Sent to Yield Reserve\n4. **Distribution**: Split 70/30 to USDs/Buyback\n\n## Security\n\n- All strategies audited\n- Multi-sig controlled deployment\n- Allocation limits prevent concentration\n- Regular security reviews\n";
+export declare const REBASE_DOCUMENTATION: string;
+export declare const ORACLE_DOCUMENTATION = "# Sperax Oracle System\n\n## Overview\n\nSperax uses Chainlink oracles for secure, decentralized price feeds.\n\n## Oracle Architecture\n\n```\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              CHAINLINK ORACLES               \u2502\n\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502  USDC/USD \u2192 0x50834F3163758fcC1Df9973b6e91f0F0F0363003 \u2502\n\u2502  USDT/USD \u2192 0x3f3f5dF88dC9F13eac63DF89EC16ef6e7E25DdE7 \u2502\n\u2502  DAI/USD  \u2192 0xc5C8E77B397E531B8EC06BFb0048328B30E9eCfB \u2502\n\u2502  FRAX/USD \u2192 0x0809E3d38d1B4214958faf06D8b1B1a2b73f2ab8 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n           \u2502\n           \u25BC\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              SPERAX VAULT                    \u2502\n\u2502  - Reads prices for minting                  \u2502\n\u2502  - Reads prices for redemption               \u2502\n\u2502  - Calculates collateral ratios              \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## Price Feed Specifications\n\n| Feed | Decimals | Heartbeat | Deviation |\n|------|----------|-----------|-----------|\n| USDC/USD | 8 | 1 hour | 0.1% |\n| USDT/USD | 8 | 1 hour | 0.1% |\n| DAI/USD | 8 | 1 hour | 0.1% |\n| FRAX/USD | 8 | 1 hour | 0.1% |\n\n## Staleness Protection\n\nOracle prices are checked for freshness:\n\n```solidity\nfunction getPrice(address oracle) returns (uint256) {\n  (, int256 price, , uint256 updatedAt, ) = oracle.latestRoundData();\n  require(block.timestamp - updatedAt < 3600, \"Stale price\");\n  require(price > 0, \"Invalid price\");\n  return uint256(price);\n}\n```\n\n## Deviation Protection\n\nStablecoins should trade near $1.00:\n\n- **Warning**: > 0.5% deviation\n- **Critical**: > 2% deviation\n- **Pause**: > 5% deviation (auto-pause minting)\n\n## Fallback Mechanism\n\nIf primary oracle fails:\n1. Check secondary oracle (if available)\n2. Use cached price (max 1 hour old)\n3. Pause operations if no valid price\n\n## Monitoring\n\nOracle health monitored 24/7:\n- Price staleness alerts\n- Deviation alerts\n- Round completion verification\n";
+export declare const GOVERNANCE_DOCUMENTATION = "# Sperax DAO Governance\n\n## Overview\n\nSperax is governed by SPA token holders through veSPA voting power.\n\n## Governance Structure\n\n```\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502                 veSPA HOLDERS                \u2502\n\u2502         (Vote-Escrowed SPA Tokens)           \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                       \u2502 Vote\n                       \u25BC\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              SNAPSHOT VOTING                 \u2502\n\u2502         (Off-chain, gas-free voting)         \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                       \u2502 Execute\n                       \u25BC\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502              TIMELOCK CONTRACT               \u2502\n\u2502         (48-hour execution delay)            \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n                       \u2502\n                       \u25BC\n\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502           PROTOCOL CONTRACTS                 \u2502\n\u2502   Vault, USDs, Strategies, Parameters        \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## Voting Power\n\nVoting power is determined by veSPA balance:\n\n```\nveSPA = SPA \u00D7 (lockDays / 365)\n```\n\nExamples:\n- Lock 1000 SPA for 1 year \u2192 1000 veSPA\n- Lock 1000 SPA for 4 years \u2192 4000 veSPA\n\n## Proposal Types\n\n### 1. Parameter Changes\n- Minting/redemption fees\n- Collateral allocation limits\n- Strategy allocations\n- Quorum: 4%\n\n### 2. Strategy Additions\n- New yield strategies\n- New collateral types\n- Quorum: 6%\n\n### 3. Protocol Upgrades\n- Contract upgrades\n- Major mechanism changes\n- Quorum: 10%\n\n## Proposal Lifecycle\n\n1. **Discussion** (Forum) - 3+ days\n2. **Temperature Check** (Snapshot) - 3 days\n3. **Formal Vote** (Snapshot) - 5 days\n4. **Timelock** - 48 hours\n5. **Execution** - 14 day window\n\n## Requirements\n\n| Action | Requirement |\n|--------|-------------|\n| Create proposal | 100,000 veSPA |\n| Vote | Any veSPA balance |\n| Quorum | 4-10% depending on type |\n| Pass | >50% FOR votes |\n\n## Delegation\n\nveSPA holders can delegate voting power:\n- Delegation does NOT transfer tokens\n- Only voting power is delegated\n- Can undelegate at any time\n";
+export declare const SECURITY_DOCUMENTATION = "# Sperax Security\n\n## Audits\n\nSperax contracts have been audited by:\n\n| Auditor | Date | Scope | Report |\n|---------|------|-------|--------|\n| OpenZeppelin | 2024-06 | Full Protocol | [Link](https://sperax.io/audits) |\n| PeckShield | 2024-03 | USDs v2 | [Link](https://sperax.io/audits) |\n| Halborn | 2023-12 | Vault | [Link](https://sperax.io/audits) |\n\n## Security Features\n\n### Smart Contract Security\n- \u2705 Audited by top firms\n- \u2705 Bug bounty program (up to $100k)\n- \u2705 Formal verification (critical functions)\n- \u2705 Reentrancy guards\n- \u2705 Integer overflow protection (Solidity 0.8+)\n\n### Oracle Security\n- \u2705 Chainlink decentralized oracles\n- \u2705 Staleness checks\n- \u2705 Deviation thresholds\n- \u2705 Circuit breakers\n\n### Access Control\n- \u2705 Multi-sig admin (4/7)\n- \u2705 48-hour timelock\n- \u2705 Role-based permissions\n- \u2705 Guardian emergency pause\n\n### Economic Security\n- \u2705 100%+ collateralization\n- \u2705 Diversified collateral\n- \u2705 Strategy risk limits\n- \u2705 Depeg protection mechanisms\n\n## Risk Factors\n\n### Smart Contract Risk\nBugs in smart contracts could lead to loss of funds.\n**Mitigation**: Multiple audits, bug bounty, insurance.\n\n### Oracle Risk\nOracle manipulation could affect pricing.\n**Mitigation**: Chainlink oracles, staleness checks, deviation limits.\n\n### Collateral Risk\nCollateral tokens could depeg.\n**Mitigation**: Diversification, monitoring, circuit breakers.\n\n### Strategy Risk\nYield strategies could be exploited.\n**Mitigation**: Allocation limits, audits, monitoring.\n\n## Bug Bounty\n\nReport vulnerabilities responsibly:\n- Email: security@sperax.io\n- Immunefi: https://immunefi.com/bounty/sperax\n\nRewards up to $100,000 for critical bugs.\n\n## Emergency Procedures\n\n### Guardian Actions\n- Pause minting/redemption\n- Pause strategies\n- Emergency withdrawal\n\n### Recovery Process\n1. Identify issue\n2. Pause affected systems\n3. Investigate root cause\n4. Deploy fix\n5. Governance approval\n6. Resume operations\n";
+export declare const API_REFERENCE = "# Sperax MCP API Reference\n\n## Tools\n\n### USDs Tools\n\n| Tool | Description |\n|------|-------------|\n| `usds_get_info` | Get USDs overview (supply, APR) |\n| `usds_get_balance` | Get balance for address |\n| `usds_get_rebase_state` | Check rebase opt-in status |\n| `usds_get_mint_params` | Get minting parameters |\n| `usds_get_yield_info` | Get yield metrics |\n| `usds_get_collateral_ratio` | Get collateralization ratio |\n\n### SPA Tools\n\n| Tool | Description |\n|------|-------------|\n| `spa_get_info` | Get SPA token overview |\n| `spa_get_balance` | Get SPA/veSPA/xSPA balances |\n| `vespa_get_position` | Get veSPA lock details |\n| `vespa_calculate_power` | Calculate veSPA for lock |\n| `vespa_get_stats` | Get global staking stats |\n| `xspa_get_position` | Get xSPA redemption options |\n| `xspa_calculate_redemption` | Calculate SPA from xSPA |\n| `buyback_get_stats` | Get buyback statistics |\n\n### Vault Tools\n\n| Tool | Description |\n|------|-------------|\n| `vault_get_status` | Get Vault health status |\n| `vault_get_collaterals` | List all collaterals |\n| `vault_get_collateral_details` | Get specific collateral info |\n| `vault_get_strategies` | List yield strategies |\n| `vault_get_strategy_details` | Get strategy details |\n| `vault_get_oracle_prices` | Get all oracle prices |\n| `vault_get_peg_status` | Check USDs peg |\n| `vault_simulate_mint` | Simulate mint operation |\n| `vault_simulate_redeem` | Simulate redeem operation |\n| `vault_get_allocation_targets` | Get allocation targets |\n\n### Demeter Tools\n\n| Tool | Description |\n|------|-------------|\n| `demeter_list_farms` | List active farms |\n| `demeter_get_farm_details` | Get farm details |\n| `demeter_get_user_position` | Get user's farm positions |\n| `demeter_calculate_rewards` | Calculate pending rewards |\n| `demeter_estimate_apr` | Estimate farm APR |\n| `demeter_get_top_farms` | Get highest APR farms |\n\n### Dripper Tools\n\n| Tool | Description |\n|------|-------------|\n| `dripper_get_status` | Get Dripper status |\n| `dripper_get_balance` | Get pending yield balance |\n| `dripper_get_config` | Get Dripper config |\n| `dripper_estimate_next_rebase` | Estimate next rebase |\n| `dripper_calculate_earnings` | Calculate earnings projection |\n\n### Oracle Tools\n\n| Tool | Description |\n|------|-------------|\n| `oracle_get_all_prices` | Get all collateral prices |\n| `oracle_get_price` | Get specific asset price |\n| `oracle_check_staleness` | Check oracle freshness |\n| `oracle_check_deviation` | Check price deviation |\n| `oracle_get_sources` | Get oracle source info |\n\n### Analytics Tools\n\n| Tool | Description |\n|------|-------------|\n| `analytics_get_tvl` | Get Total Value Locked |\n| `analytics_get_revenue` | Get protocol revenue |\n| `analytics_get_apy_history` | Get historical APY |\n| `analytics_get_user_stats` | Get user statistics |\n| `analytics_compare_yields` | Compare with competitors |\n| `analytics_get_protocol_health` | Get health metrics |\n\n### Governance Tools\n\n| Tool | Description |\n|------|-------------|\n| `governance_get_overview` | Get governance overview |\n| `governance_get_proposals` | List proposals |\n| `governance_get_proposal_details` | Get proposal details |\n| `governance_get_voting_power` | Get voting power |\n| `governance_get_delegates` | Get delegation info |\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `sperax://docs/overview` | Protocol overview |\n| `sperax://docs/usds` | USDs documentation |\n| `sperax://docs/staking` | Staking guide |\n| `sperax://docs/demeter` | Farming guide |\n| `sperax://docs/vault` | Vault documentation |\n| `sperax://docs/oracles` | Oracle documentation |\n| `sperax://docs/governance` | Governance guide |\n| `sperax://docs/security` | Security information |\n| `sperax://docs/formulas` | Protocol formulas |\n| `sperax://docs/api` | This API reference |\n| `sperax://contracts/addresses` | Contract addresses |\n\n## Prompts\n\n| Prompt | Description |\n|--------|-------------|\n| `what_is_usds` | Explain USDs |\n| `how_to_mint` | Mint tutorial |\n| `how_to_redeem` | Redeem tutorial |\n| `my_usds_balance` | Check balance |\n| `my_yield_earnings` | Earnings report |\n| `stake_spa` | Staking guide |\n| `my_staking_position` | Position check |\n| `best_yield_farms` | Farm discovery |\n| `my_farm_rewards` | Pending rewards |\n| `protocol_health` | Health check |\n| `spa_tokenomics` | Token info |\n| `compare_yields` | Yield comparison |\n| `rebase_calculator` | Calculate rebases |\n| `vespa_calculator` | Calculate veSPA |\n| `portfolio_summary` | Full portfolio |\n| `optimize_my_yield` | AI optimization |\n| `risk_assessment` | Risk analysis |\n| `weekly_report` | Weekly summary |\n";
+export declare const CONTRACT_ADDRESSES: {
+    chain: string;
+    chainId: number;
+    contracts: {
+        readonly USDS: "0xD74f5255D557944cf7Dd0E45FF521520002D5748";
+        readonly SPA: "0x5575552988A3A80504bBaeB1311674fCFd40aD4B";
+        readonly VAULT: "0x6Bbc476Ee35CBA9e9c3A59fc5b10d7a0BC6f74Ca";
+        readonly VESPA: "0x2e2071180682Ce6C247B1eF93d382D509F5F6A17";
+        readonly XSPA: "0x0966E72256d6055145902F72F9D3B6a194B9cCc3";
+        readonly SPA_BUYBACK: "0xFbc0d3cA777722d234FE01dba94DeDeDb277AFe3";
+        readonly YIELD_RESERVE: "0x0CB89A7A6a9E0d9E06EE0c52De040db0e2B079E6";
+        readonly DRIPPER: "0xEaA79893D17d4c1b3e76c684e7A89B3D46a6fb03";
+        readonly REBASE_MANAGER: "0xC21b3b55Db3cb0B6CA6F96c18E9534c96E1d4cfc";
+        readonly COLLATERAL_MANAGER: "0xdA6B48BA29fE5F0f32eB52FBA21D26DACA04E5e7";
+        readonly MASTER_PRICE_ORACLE: "0x14D99412dAB1878dC01Fe7a1664cdE85896e8E50";
+        readonly CHAINLINK_ORACLE: "0xB9e5A70e1B1F3C99Db6Ed28f67d8d7d1248F8b3B";
+        readonly SPA_ORACLE: "0x5Fb534B4B07a0E417B449E264A8c7A6f9C5C2C69";
+        readonly USDS_ORACLE: "0x1C27c2a4aD63DE5F44f5a0e7a651e3FC7F3BBBe3";
+        readonly FARM_REGISTRY: "0x45bC6B44107837E7aBB21E2CaCbe7612Fce222e0";
+        readonly REWARDER_FACTORY: "0x926477bAF60C25857419CC9Bf52E914881E1bDD3";
+        readonly FARM_DEPLOYER: "0x0d9EFD8f11c0a09DB8C2CCBfF4cC6c26Ad98b956";
+        readonly USDC: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+        readonly USDCe: "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8";
+        readonly USDT: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9";
+        readonly DAI: "0xDA10009cBd5D07dd0CeCc66161FC93D7c9000da1";
+        readonly FRAX: "0x17FC002b466eEc40DaE837Fc4bE5c67993ddBd6F";
+        readonly AAVE_STRATEGY: "0x5E8422345238F34275888049021821E8E08CAa1f";
+        readonly COMPOUND_STRATEGY: "0x8c9532a60E0E7C6BbD2B2c1303F63aCE1c3e9811";
+        readonly STARGATE_STRATEGY: "0x6cD7bEF920f4C05aF3386A2c0070e1e26CD85c85";
+        readonly FLUID_STRATEGY: "0xE0f51Ec5f35B0D7Ce31b26b8C15b9B9f3fF1f5C5";
+        readonly FEE_CALCULATOR: "0xC2C3D9F5C5A5dE5A5a5c5D5e5F5A5b5c5D5E5F5a";
+        readonly MULTICALL3: "0xcA11bde05977b3631167028862bE2a173976CA11";
+    };
+    collaterals: {
+        [k: string]: string;
+    };
+};
+export declare const AGENTS_DOCUMENTATION = "# SperaxOS DeFi Agents\n\n## Overview\n\nThe DeFi Agents API provides access to 58+ production-ready AI agent definitions for DeFi, portfolio management, trading, and Web3 workflows.\n\n**API Base URL:** `https://sperax.click`\n**Repository:** https://github.com/speraxos/SperaxOS-Defi-Agents\n\n## Features\n\n- \u2705 **58+ Production-Ready Agents** - DeFi, portfolio, trading, security, education\n- \u2705 **18 Languages** - Full i18n support\n- \u2705 **RESTful JSON API** - Easy integration\n- \u2705 **Sperax Ecosystem Agents** - USDs, SPA, veSPA specialists\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `agents_list` | List all available DeFi agents with filtering |\n| `agents_get` | Get complete agent details and system prompt |\n| `agents_search` | Search agents by keyword |\n| `agents_get_sperax` | Get Sperax-specific agents |\n| `agents_get_categories` | List agent categories and counts |\n\n## Sperax Ecosystem Agents\n\n- **USDs Stablecoin Expert** - Auto-yield stablecoin specialist\n- **SPA Tokenomics Analyst** - Token economics expert\n- **veSPA Lock Optimizer** - Staking strategy advisor\n- **Sperax Governance Guide** - DAO participation helper\n- **Sperax Yield Aggregator** - Yield optimization specialist\n- **Sperax Portfolio Tracker** - Portfolio management\n\n## Usage Example\n\n```\nUse agents_list with category \"sperax\" to find ecosystem agents\nUse agents_get with identifier \"usds-stablecoin-expert\" to get full prompt\n```\n\n## API Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `/index.json` | All agents (English) |\n| `/index.{locale}.json` | Agents in specific language |\n| `/{identifier}.json` | Single agent details |\n";
+export declare const PLUGINS_DOCUMENTATION = "# SperaxOS Plugin Marketplace\n\n## Overview\n\nPlugin Delivery is the official plugin marketplace for SperaxOS, providing AI function call plugins for crypto and DeFi operations.\n\n**Plugin Index:** `https://plugin.delivery`\n**Repository:** https://github.com/nirholas/plugin.delivery\n\n## Features\n\n- \u2705 **AI Function Calls** - LLM-compatible plugin system\n- \u2705 **Gateway Service** - Secure request routing\n- \u2705 **TypeScript SDK** - `@sperax/plugin-sdk`\n- \u2705 **Multiple Plugin Types** - Default, Markdown, Standalone\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `plugins_list` | List all available plugins |\n| `plugins_get_manifest` | Get plugin manifest and functions |\n| `plugins_execute` | Execute plugin function via gateway |\n| `plugins_coingecko_price` | Get crypto prices from CoinGecko |\n| `plugins_defillama_tvl` | Get protocol TVL from DefiLlama |\n| `plugins_search` | Search plugins by keyword |\n\n## Available Plugins\n\n| Plugin | Description |\n|--------|-------------|\n| \uD83E\uDE99 **CoinGecko** | Crypto prices, market data |\n| \uD83E\uDD99 **DefiLlama** | Protocol TVL, yields |\n\n## Plugin Types\n\n1. **Default** - JSON response rendered as text\n2. **Markdown** - Rich markdown formatting\n3. **Standalone** - Interactive React UI\n\n## Usage Example\n\n```\nUse plugins_coingecko_price with coinId \"ethereum\" to get ETH price\nUse plugins_defillama_tvl with protocol \"sperax\" to get Sperax TVL\n```\n";
+export declare const NEWS_DOCUMENTATION = "# Free Crypto News API\n\n## Overview\n\nReal-time crypto news aggregation from 7 major sources with no API keys or rate limits required.\n\n**API Base URL:** `https://free-crypto-news.vercel.app`\n**Repository:** https://github.com/speraxos/crypto-news\n\n## News Sources\n\n| Source | Category | Emoji |\n|--------|----------|-------|\n| CoinDesk | General | \uD83D\uDFE0 |\n| The Block | Institutional | \uD83D\uDD35 |\n| Decrypt | Web3 & Culture | \uD83D\uDFE2 |\n| CoinTelegraph | Global | \uD83D\uDFE1 |\n| Bitcoin Magazine | Bitcoin | \uD83D\uDFE4 |\n| Blockworks | DeFi & Institutions | \uD83D\uDFE3 |\n| The Defiant | DeFi Native | \uD83D\uDD34 |\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `news_get_latest` | Latest news from all sources |\n| `news_search` | Search by keywords |\n| `news_get_defi` | DeFi-specific news |\n| `news_get_bitcoin` | Bitcoin-specific news |\n| `news_get_breaking` | Breaking news (last 2 hours) |\n| `news_get_sources` | List all news sources |\n| `news_get_sperax` | Sperax-related news |\n\n## Features\n\n- \u2705 **100% Free** - No API keys required\n- \u2705 **No Rate Limits** - Fair use policy\n- \u2705 **Real-time** - RSS feed aggregation\n- \u2705 **7 Sources** - Comprehensive coverage\n\n## API Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `/api/news` | Latest from all sources |\n| `/api/search?q=keyword` | Search by keywords |\n| `/api/defi` | DeFi-specific news |\n| `/api/bitcoin` | Bitcoin-specific news |\n| `/api/breaking` | News from last 2 hours |\n| `/api/sources` | List all sources |\n\n## Usage Example\n\n```\nUse news_get_latest with limit 5 to get recent headlines\nUse news_search with keywords \"ethereum,etf\" for topic-specific news\nUse news_get_breaking for time-sensitive updates\n```\n\n## Response Format\n\n```json\n{\n  \"articles\": [\n    {\n      \"title\": \"Article Title\",\n      \"link\": \"https://...\",\n      \"description\": \"Brief description\",\n      \"source\": \"CoinDesk\",\n      \"timeAgo\": \"2h ago\"\n    }\n  ],\n  \"totalCount\": 150,\n  \"fetchedAt\": \"2025-01-02T14:30:00Z\"\n}\n```\n";
+export declare const resources: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string;
+}[];
+//# sourceMappingURL=resources.d.ts.map

package/build/sperax/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/sperax/resources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,eAAO,MAAM,iBAAiB,QAyD7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAyE9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,QA4FjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,QA2FjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,QA+ElC,CAAC;AAMF,eAAO,MAAM,mBAAmB,+vIAwF/B,CAAC;AAMF,eAAO,MAAM,2BAA2B,QA0FvC,CAAC;AAMF,eAAO,MAAM,wBAAwB,8oEAiFpC,CAAC;AAMF,eAAO,MAAM,oBAAoB,QAuFhC,CAAC;AAMF,eAAO,MAAM,oBAAoB,6uGAsEhC,CAAC;AAMF,eAAO,MAAM,wBAAwB,6oIAsFpC,CAAC;AAMF,eAAO,MAAM,sBAAsB,6hEA+ElC,CAAC;AAMF,eAAO,MAAM,aAAa,qpJAqIzB,CAAC;AAMF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAO9B,CAAC;AAMF,eAAO,MAAM,oBAAoB,isDAiDhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,y9CA8CjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,4mEA4E9B,CAAC;AAMF,eAAO,MAAM,SAAS;;;;;;GAyHrB,CAAC"}