mantle-agent-kit-sdk 1.1.0 → 1.1.2

package/README.md

@@ -44,6 +44,9 @@ const txHash = await agent.sendTransaction(
 | **mETH Protocol** | Mainnet | Liquid staking token |
 | **PikePerps** | Testnet | Perpetual futures trading (up to 100x) |
 | **Squid Router** | Mainnet | Cross-chain swaps via Axelar |
+| **Pyth Network** | Both | Real-time price oracles (80+ assets) |
+| **Token Launchpad** | Both | Deploy ERC20 tokens & RWAs |
+| **NFT Launchpad** | Both | Deploy & mint ERC721 NFT collections |
 
 ## API Reference
 
@@ -356,6 +359,402 @@ const txHash = await agent.crossChainSwapViaSquid(
 
 ---
 
+### Pyth Network - Price Oracles
+
+Real-time price feeds for 80+ assets including crypto, forex, commodities, and equities.
+
+**All Pyth functions accept three input types:**
+- **Pair name**: `"ETH/USD"`, `"BTC/USD"`, `"MNT/USD"`
+- **Token address**: `"0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2"` (USDC on Mantle)
+- **Price feed ID**: `"0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace"`
+
+#### Get Single Price
+
+```typescript
+// Using pair name
+const price = await agent.pythGetPrice("ETH/USD");
+
+// Using token address (USDC on Mantle)
+const usdcPrice = await agent.pythGetPrice("0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2");
+
+// Using mETH token address
+const methPrice = await agent.pythGetPrice("0xcDA86A272531e8640cD7F1a92c01839911B90bb0");
+
+// Returns: PythPriceResponse
+// {
+//   priceFeedId: string,    // "0xff61491a..."
+//   pair: string,           // "ETH/USD"
+//   price: string,          // Raw price (e.g., "345000000000")
+//   confidence: string,     // Confidence interval
+//   exponent: number,       // Price exponent (e.g., -8)
+//   publishTime: number,    // Unix timestamp
+//   formattedPrice: string  // Human readable (e.g., "3450.00")
+// }
+```
+
+#### Get EMA Price
+
+```typescript
+const emaPrice = await agent.pythGetEmaPrice("ETH/USD");
+// Also accepts token addresses
+const emaByAddress = await agent.pythGetEmaPrice("0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2");
+// Returns: PythPriceResponse (same structure as above)
+```
+
+#### Get Token Price by Address
+
+Pass any token contract address and get full price details:
+
+```typescript
+const price = await agent.pythGetTokenPrice("0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2");
+
+// Returns: PythTokenPriceResponse
+// {
+//   tokenAddress: "0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2",
+//   tokenSymbol: "USDC",
+//   pair: "USDC/USD",
+//   priceFeedId: "0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a",
+//   priceUsd: "1.00",
+//   confidence: "50000",
+//   exponent: -8,
+//   publishTime: 1704700800,
+//   lastUpdated: "2024-01-08T12:00:00.000Z"
+// }
+
+// More examples
+const methPrice = await agent.pythGetTokenPrice("0xcDA86A272531e8640cD7F1a92c01839911B90bb0"); // mETH
+const wethPrice = await agent.pythGetTokenPrice("0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111"); // WETH
+const wmntPrice = await agent.pythGetTokenPrice("0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8"); // WMNT
+```
+
+#### Get Multiple Prices
+
+```typescript
+// Mix pair names and token addresses
+const prices = await agent.pythGetMultiplePrices([
+  "BTC/USD",                                      // pair name
+  "ETH/USD",                                      // pair name
+  "0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2", // USDC address
+  "0xcDA86A272531e8640cD7F1a92c01839911B90bb0", // mETH address
+]);
+// Returns: PythPriceResponse[]
+```
+
+#### Get Supported Price Feeds
+
+```typescript
+const feeds = agent.pythGetSupportedPriceFeeds();
+// Returns: Record<string, string>
+// {
+//   "BTC/USD": "e62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43",
+//   "ETH/USD": "ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace",
+//   ... 80+ more
+// }
+```
+
+#### Get Supported Token Addresses
+
+```typescript
+const addresses = agent.pythGetSupportedTokenAddresses();
+// Returns: Record<string, string>
+// {
+//   "0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2": "USDC/USD",
+//   "0xcDA86A272531e8640cD7F1a92c01839911B90bb0": "mETH/USD",
+//   "0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8": "MNT/USD",
+//   ... more Mantle tokens
+// }
+```
+
+#### Check Price Feed Exists
+
+```typescript
+// Works with pair names or token addresses
+const exists = await agent.pythPriceFeedExists("ETH/USD");
+const existsByAddress = await agent.pythPriceFeedExists("0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2");
+// Returns: boolean
+```
+
+#### Supported Token Addresses (Mantle Network)
+
+| Token | Address | Price Feed |
+|-------|---------|------------|
+| WMNT | `0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8` | MNT/USD |
+| WETH | `0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111` | ETH/USD |
+| USDC | `0x09Bc4E0D10C81b3a3766c49F0f98a8aaa7adA8D2` | USDC/USD |
+| USDT | `0x201EBa5CC46D216Ce6DC03F6a759e8E766e956aE` | USDT/USD |
+| mETH | `0xcDA86A272531e8640cD7F1a92c01839911B90bb0` | mETH/USD |
+| WBTC | `0xCAbAE6f6Ea1ecaB08Ad02fE02ce9A44F09aebfA2` | WBTC/USD |
+| FBTC | `0xc96de26018a54d51c097160568752c4e3bd6c364` | BTC/USD |
+| PENDLE | `0xf83bcc06D6A4A5682adeCA11CF9500f67bFe61AE` | PENDLE/USD |
+
+#### Supported Asset Categories
+
+| Category | Examples |
+|----------|----------|
+| **Crypto (50+)** | BTC, ETH, SOL, BNB, XRP, ADA, DOGE, AVAX, LINK, UNI, AAVE... |
+| **Layer 2** | ARB, OP, MNT, STRK, IMX |
+| **DeFi** | AAVE, CRV, MKR, SNX, LDO, GMX, PENDLE |
+| **Stablecoins** | USDC, USDT, DAI, FRAX, BUSD |
+| **LST Tokens** | stETH, wstETH, cbETH, rETH, mETH |
+| **Meme Coins** | SHIB, PEPE, BONK, WIF, FLOKI |
+| **Forex** | EUR/USD, GBP/USD, JPY/USD |
+| **Commodities** | XAU (Gold), XAG (Silver), WTI, BRENT |
+| **Equities** | AAPL, NVDA, TSLA, MSFT, GOOGL, AMZN |
+
+---
+
+### Token Launchpad
+
+Deploy ERC20 tokens and RWA (Real World Asset) tokens with supply minted to your address.
+
+#### Deploy Standard Token
+
+```typescript
+const result = await agent.deployStandardToken(
+  name: string,    // e.g., "My Token"
+  symbol: string,  // e.g., "MTK"
+  supply: string   // Human readable, e.g., "1000000" (1M tokens)
+);
+
+// Returns: TokenDeploymentResult
+// {
+//   tokenAddress: string,  // Deployed contract address
+//   txHash: string,        // Transaction hash
+//   name: string,
+//   symbol: string,
+//   decimals: number,      // Always 18
+//   totalSupply: string,   // Supply in wei
+//   mintedTo: string,      // Your wallet address
+//   tokenType: "standard"
+// }
+```
+
+#### Deploy RWA Token
+
+```typescript
+const result = await agent.deployRWAToken(
+  name: string,      // e.g., "Manhattan Property Token"
+  symbol: string,    // e.g., "MPT"
+  supply: string,    // Fractional shares, e.g., "10000"
+  assetType: string, // "Real Estate" | "Commodities" | "Securities" | "Art"
+  assetId?: string   // External reference, e.g., "PROP-NYC-001"
+);
+
+// Returns: TokenDeploymentResult
+// {
+//   tokenAddress: string,
+//   txHash: string,
+//   name: string,
+//   symbol: string,
+//   decimals: number,
+//   totalSupply: string,
+//   mintedTo: string,
+//   tokenType: "rwa",
+//   assetType: string,   // "Real Estate"
+//   assetId: string      // "PROP-NYC-001"
+// }
+```
+
+#### Generic Token Deployment
+
+```typescript
+const result = await agent.deployToken(
+  name: string,
+  symbol: string,
+  supply: string,
+  tokenType?: "standard" | "rwa",  // default: "standard"
+  assetType?: string,              // For RWA only
+  assetId?: string                 // For RWA only
+);
+```
+
+#### Get Token Info
+
+```typescript
+const info = await agent.getTokenInfo(
+  tokenAddress: Address,
+  holder?: Address  // Optional: get balance for this address
+);
+
+// Returns: TokenInfo
+// {
+//   address: string,
+//   name: string,
+//   symbol: string,
+//   decimals: number,
+//   totalSupply: string,
+//   balance?: string  // If holder provided
+// }
+```
+
+#### Get Token Balance
+
+```typescript
+const balance = await agent.getTokenBalance(
+  tokenAddress: Address,
+  holder?: Address  // Defaults to agent address
+);
+// Returns: string (balance in wei)
+```
+
+#### Transfer Tokens
+
+```typescript
+const txHash = await agent.transferToken(
+  tokenAddress: Address,
+  to: Address,
+  amount: string  // Amount in wei
+);
+// Returns: Hex (transaction hash)
+```
+
+---
+
+### NFT Launchpad
+
+Deploy ERC721 NFT collections and mint NFTs.
+
+#### Deploy NFT Collection
+
+```typescript
+const result = await agent.deployNFTCollection({
+  name: string,      // e.g., "My NFT Collection"
+  symbol: string,    // e.g., "MNFT"
+  baseURI: string,   // e.g., "ipfs://QmXXX/"
+  maxSupply?: number // 0 for unlimited
+});
+
+// Returns: NFTCollectionDeploymentResult
+// {
+//   collectionAddress: string,
+//   txHash: string,
+//   name: string,
+//   symbol: string,
+//   baseURI: string,
+//   maxSupply: number,
+//   deployer: string
+// }
+```
+
+#### Deploy with Preset
+
+```typescript
+const result = await agent.deployNFTCollectionWithPreset(
+  preset: "pfp" | "art" | "membership" | "unlimited",
+  name: string,
+  symbol: string,
+  baseURI: string
+);
+// Presets: pfp=10000, art=1000, membership=100, unlimited=0
+```
+
+#### Mint NFT
+
+```typescript
+const result = await agent.mintNFT(
+  collectionAddress: Address,
+  to?: Address  // Defaults to agent address
+);
+
+// Returns: NFTMintResult
+// {
+//   txHash: string,
+//   tokenId: string,
+//   collectionAddress: string,
+//   to: string
+// }
+```
+
+#### Batch Mint
+
+```typescript
+const result = await agent.batchMintNFT(
+  collectionAddress: Address,
+  to: Address,
+  quantity: number
+);
+
+// Returns:
+// {
+//   txHash: Hex,
+//   startTokenId: string,
+//   quantity: number
+// }
+```
+
+#### Get Collection Info
+
+```typescript
+const info = await agent.getNFTCollectionInfo(
+  collectionAddress: Address,
+  holder?: Address
+);
+
+// Returns: NFTCollectionInfo
+// {
+//   address: string,
+//   name: string,
+//   symbol: string,
+//   totalSupply: string,
+//   balanceOf?: string  // If holder provided
+// }
+```
+
+#### Get Token Info
+
+```typescript
+const info = await agent.getNFTTokenInfo(
+  collectionAddress: Address,
+  tokenId: string
+);
+
+// Returns: NFTTokenInfo
+// {
+//   collectionAddress: string,
+//   tokenId: string,
+//   owner: string,
+//   tokenURI: string
+// }
+```
+
+#### Transfer NFT
+
+```typescript
+// Standard transfer
+const txHash = await agent.transferNFT(
+  collectionAddress: Address,
+  to: Address,
+  tokenId: string
+);
+
+// Safe transfer (checks recipient)
+const txHash = await agent.safeTransferNFT(
+  collectionAddress: Address,
+  to: Address,
+  tokenId: string
+);
+```
+
+#### Approve NFT
+
+```typescript
+// Approve single NFT
+const txHash = await agent.approveNFT(
+  collectionAddress: Address,
+  approved: Address,
+  tokenId: string
+);
+
+// Approve all NFTs in collection
+const txHash = await agent.setApprovalForAllNFT(
+  collectionAddress: Address,
+  operator: Address,
+  approved: boolean
+);
+```
+
+---
+
 ## Configuration
 
 ### Environment Variables
@@ -415,6 +814,7 @@ const result = await demoAgent.swapOnUniswap(tokenA, tokenB, amount);
 
 | Protocol | Contract | Address |
 |----------|----------|---------|
+| **Pyth Network** | Oracle | `0xA2aa501b19aff244D90cc15a4Cf739D2725B5729` |
 | **mETH** | Token | `0xcDA86A272531e8640cD7F1a92c01839911B90bb0` |
 | **WETH** | Token | `0xdEAddEaDdeadDEadDEADDEAddEADDEAddead1111` |
 | **WMNT** | Token | `0x78c1b0C915c4FAA5FffA6CAbf0219DA63d7f4cb8` |
@@ -429,6 +829,7 @@ const result = await demoAgent.swapOnUniswap(tokenA, tokenB, amount);
 
 | Protocol | Contract | Address |
 |----------|----------|---------|
+| **Pyth Network** | Oracle | `0x98046Bd286715D3B0BC227Dd7a956b83D8978603` |
 | **PikePerps** | PerpetualTrading | `0x8081b646f349c049f2d5e8a400057d411dd657bd` |
 | **PikePerps** | BondingCurveMarket | `0x93b268325A9862645c82b32229f3B52264750Ca2` |