@tangle-network/starter-foundry 0.5.4 → 0.7.0

package/registry/partners/lens/manifest.json

@@ -0,0 +1,44 @@
+{
+  "id": "lens",
+  "description": "Partner pack for Lens Protocol — decentralized social graph on Lens Chain (zkEVM L2). Biases toward social apps, creator platforms, and feeds that want portable identity + content ownership.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "expo-react-native-ts",
+    "api-service",
+    "agent-service-ts",
+    "worker-job"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Build on Lens — portable social graph",
+    "subheadline": "Decentralized profiles, follows, and content on Lens Chain. Users own their graph — you own the UX."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions Lens, social graph, decentralized social, creator platform, or portable profiles/follows across apps.",
+    "firstSteps": [
+      "Install @lens-protocol/client for TS or use the GraphQL API directly (https://api.lens.xyz). API keys optional but recommended for rate limits.",
+      "Authentication uses SIWE (Sign-In With Ethereum) — reuse the existing viem/wagmi flow; don't build a separate auth stack.",
+      "For posting content (publications), sign a typed-data message and submit through the Lens API — gasless via Lens relayer by default."
+    ],
+    "gotchas": [
+      "Lens v3 runs on Lens Chain (its own zkEVM L2) — chainId 232. The v2 Polygon deployment is deprecated; don't read Polygon Lens contracts for new work.",
+      "Profile ownership and content are separate NFTs — handle each in token metadata flows; losing profile access ≠ losing published posts.",
+      "The GraphQL API is the primary interface; direct contract reads work but miss the indexed view (mirrors, reactions, feed ranking)."
+    ]
+  }
+}

package/registry/partners/linea/files/partner-config.json

@@ -0,0 +1,13 @@
+{
+  "partnerId": "linea",
+  "chainId": 59144,
+  "networkName": "linea-mainnet",
+  "rpcUrl": "https://rpc.linea.build",
+  "testnetChainId": 59141,
+  "testnetRpcUrl": "https://rpc.sepolia.linea.build",
+  "explorerUrl": "https://lineascan.build",
+  "bridgeUrl": "https://bridge.linea.build",
+  "blockTimeMs": 2000,
+  "runtimeFocus": "zkevm-l2-consumer",
+  "preferredOutputs": ["consumer-dapps", "metamask-native-ux", "cheap-l2-defi"]
+}

package/registry/partners/linea/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "linea",
+  "brandTone": "zkevm-consumer-l2",
+  "primaryColor": "#61DFFF"
+}

package/registry/partners/linea/manifest.json

@@ -0,0 +1,45 @@
+{
+  "id": "linea",
+  "description": "Partner pack for Linea — ConsenSys zkEVM L2 with full Ethereum bytecode equivalence, MetaMask-native UX. Biases toward consumer dApps that need cheap tx + the widest possible EVM wallet support.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "worker-job",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Ship on Linea — zkEVM with MetaMask-native UX",
+    "subheadline": "ConsenSys zkEVM L2; bytecode-equivalent, cheap, first-class MetaMask wallet integration."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions Linea, zkEVM L2, MetaMask-integrated dApp, or ConsenSys ecosystem.",
+    "firstSteps": [
+      "Linea mainnet chainId 59144, testnet (Sepolia) 59141. RPCs default to the Infura endpoints in partner-config.json.",
+      "Bytecode-equivalent with Ethereum — no Linea-specific opcodes, precompiles, or compiler flags. Deploy exactly as on mainnet.",
+      "MetaMask SDK is first-class; prefer `@metamask/sdk` over WalletConnect for Linea consumer flows."
+    ],
+    "gotchas": [
+      "Linea withdrawals to L1 have a ~1-3 hour proof window typical for zkEVMs; don't promise instant L2→L1 bridging.",
+      "Bridge official only through the Linea-provided bridge (bridge.linea.build) for canonical assets — third-party bridges can mint non-canonical variants."
+    ]
+  }
+}

package/registry/partners/monad/files/partner-config.json

@@ -0,0 +1,10 @@
+{
+  "partnerId": "monad",
+  "chainId": 10143,
+  "networkName": "monad-testnet",
+  "rpcUrl": "https://testnet-rpc.monad.xyz",
+  "explorerUrl": "https://testnet.monadexplorer.com",
+  "blockTimeMs": 1000,
+  "runtimeFocus": "parallel-evm-l1",
+  "preferredOutputs": ["high-throughput-defi", "on-chain-games", "low-latency-agents"]
+}

package/registry/partners/monad/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "monad",
+  "brandTone": "high-performance-evm",
+  "primaryColor": "#836EF9"
+}

package/registry/partners/monad/manifest.json

@@ -0,0 +1,46 @@
+{
+  "id": "monad",
+  "description": "Partner pack for Monad — parallel-execution EVM L1 with 10k TPS, 1s block time, bytecode-compatible. Biases toward high-throughput DeFi, real-time games on-chain, and latency-sensitive agents.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "agent-service-py",
+    "worker-job",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Ship on Monad — 10k TPS parallel EVM",
+    "subheadline": "Bytecode-compatible with Ethereum; tuned for high-throughput DeFi, on-chain games, and low-latency agent flows."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions Monad, parallel EVM, or high-TPS DeFi that would stress Ethereum mainnet.",
+    "firstSteps": [
+      "Configure the chainId (testnet: 10143) and rpcUrl (testnet: https://testnet-rpc.monad.xyz) in partner-config.json — use devnet for local work, testnet for integrations.",
+      "For forge-contracts / hardhat-contracts: add the Monad RPC as a network entry and deploy with the usual toolchain — no Monad-specific compiler flags.",
+      "For evm-infra-ts: default to 1s block-time polling; Monad produces blocks 12× faster than Ethereum mainnet so tune indexer cadence accordingly."
+    ],
+    "gotchas": [
+      "Monad is NOT an OP-stack or zk rollup — it's a parallel-execution L1. Don't assume OP proofs, rollup withdrawal windows, or L1 settlement patterns apply.",
+      "Transaction ordering semantics differ from serial-execution chains; avoid assumptions that tx A settled before tx B just because A was submitted first unless you check block ordering."
+    ]
+  }
+}

package/registry/partners/polygon/files/partner-config.json

@@ -0,0 +1,16 @@
+{
+  "partnerId": "polygon",
+  "chainId": 137,
+  "networkName": "polygon-pos-mainnet",
+  "rpcUrl": "https://polygon-rpc.com",
+  "testnetChainId": 80002,
+  "testnetRpcUrl": "https://rpc-amoy.polygon.technology",
+  "zkEvmChainId": 1101,
+  "zkEvmRpcUrl": "https://zkevm-rpc.com",
+  "explorerUrl": "https://polygonscan.com",
+  "bridgeUrl": "https://portal.polygon.technology",
+  "blockTimeMs": 2000,
+  "nativeAsset": "MATIC",
+  "runtimeFocus": "pos-or-zkevm-with-agglayer",
+  "preferredOutputs": ["nft-drops", "consumer-payments", "cross-chain-dapps"]
+}

package/registry/partners/polygon/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "polygon",
+  "brandTone": "consumer-scale-evm",
+  "primaryColor": "#8247E5"
+}

package/registry/partners/polygon/manifest.json

@@ -0,0 +1,46 @@
+{
+  "id": "polygon",
+  "description": "Partner pack for Polygon — PoS chain + Polygon zkEVM + AggLayer for cross-chain liquidity. Biases toward consumer-scale dApps, NFTs, and payments where low fees + Ethereum compatibility matter more than raw throughput.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "agent-service-py",
+    "worker-job",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Ship on Polygon — consumer-scale EVM with AggLayer",
+    "subheadline": "PoS + zkEVM + AggLayer. Low fees, wide wallet support, cross-chain composability."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions Polygon, MATIC, zkEVM, NFT drop, consumer-scale dApp, or payments rail needing sub-cent gas.",
+    "firstSteps": [
+      "Polygon PoS chainId 137 (mainnet) / 80002 (Amoy testnet). Polygon zkEVM chainId 1101 / 2442 (Cardona testnet).",
+      "Decide PoS vs zkEVM early: PoS = widest liquidity + cheapest gas; zkEVM = Ethereum security + higher composability with L1.",
+      "Bridge via the official Polygon Portal (portal.polygon.technology) for PoS ↔ Ethereum. For AggLayer cross-chain messaging, see docs.polygon.technology/agglayer."
+    ],
+    "gotchas": [
+      "PoS reorgs happen — Polygon PoS has produced 100+ block reorgs historically. Wait for ≥128 confirmations for financial finality, not just 1.",
+      "zkEVM and PoS are NOT the same chain; an asset on PoS is not available on zkEVM without explicit bridging. Check chainId at every contract boundary."
+    ]
+  }
+}

package/registry/partners/sei-evm/files/partner-config.json

@@ -0,0 +1,12 @@
+{
+  "partnerId": "sei-evm",
+  "chainId": 1329,
+  "networkName": "sei-mainnet",
+  "rpcUrl": "https://evm-rpc.sei-apis.com",
+  "testnetChainId": 1328,
+  "testnetRpcUrl": "https://evm-rpc-testnet.sei-apis.com",
+  "explorerUrl": "https://seitrace.com",
+  "blockTimeMs": 390,
+  "runtimeFocus": "parallel-evm-cosmos-interop",
+  "preferredOutputs": ["orderbook-dex", "real-time-trading", "cosmos-ibc-bridges"]
+}

package/registry/partners/sei-evm/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "sei-evm",
+  "brandTone": "fast-evm-trading",
+  "primaryColor": "#9E1F19"
+}

package/registry/partners/sei-evm/manifest.json

@@ -0,0 +1,45 @@
+{
+  "id": "sei-evm",
+  "description": "Partner pack for Sei v2 — parallelized EVM + native Cosmos interop, sub-400ms block time. Biases toward trading, orderbook DEXes, and latency-sensitive payments.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "worker-job",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Ship on Sei — parallel EVM + Cosmos interop",
+    "subheadline": "Sub-400ms finality optimized for trading, orderbook DEXes, and real-time payments."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions Sei, parallelized EVM with Cosmos-style interop, or orderbook-style on-chain trading venues.",
+    "firstSteps": [
+      "Sei v2 chainId (mainnet): 1329; testnet (atlantic-2): 1328. RPCs in partner-config.json default to the public endpoints.",
+      "Use the same forge/hardhat toolchain as any EVM; Sei v2 is fully EVM-equivalent at the RPC level.",
+      "For native Cosmos flows (IBC transfers, staking), use sei-js or CosmJS alongside viem — don't try to route Cosmos messages through evm RPC."
+    ],
+    "gotchas": [
+      "Sei v1 (Cosmos-only) and Sei v2 (EVM) share ecosystem but are different execution layers. Make sure code targets v2 RPC if deploying Solidity.",
+      "Block time ~390ms is faster than most indexers default to — reduce poll intervals for live dashboards or use WebSocket subscriptions."
+    ]
+  }
+}

package/registry/partners/sui/files/sui-config.json

@@ -0,0 +1,18 @@
+{
+  "partner": "sui",
+  "networks": {
+    "mainnet": "https://fullnode.mainnet.sui.io:443",
+    "testnet": "https://fullnode.testnet.sui.io:443",
+    "devnet": "https://fullnode.devnet.sui.io:443"
+  },
+  "sdk": {
+    "typescript": "@mysten/sui",
+    "wallet": "@mysten/wallet-kit",
+    "zkLogin": "@mysten/zklogin"
+  },
+  "docs": {
+    "move": "https://docs.sui.io/concepts/sui-move-concepts",
+    "zklogin": "https://docs.sui.io/concepts/cryptography/zklogin",
+    "sponsoredTx": "https://docs.sui.io/concepts/transactions/sponsored-transactions"
+  }
+}

package/registry/partners/sui/manifest.json

@@ -0,0 +1,41 @@
+{
+  "id": "sui",
+  "description": "Partner pack for Sui \u2014 Move-based L1 with object-centric model, parallel execution, zkLogin. Biases toward Sui Move contracts + the @mysten/sui TypeScript SDK.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "agent-service-ts",
+    "move-contracts"
+  ],
+  "slotDefaults": {
+    "database": "database:sqlite"
+  },
+  "defaults": {
+    "headline": "Build on Sui \u2014 object-centric Move with parallel execution",
+    "subheadline": "zkLogin-backed auth, sub-second finality, gas-less UX via sponsored transactions."
+  },
+  "files": [
+    {
+      "source": "files/sui-config.json",
+      "target": "sui-config.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Attach for Sui-native products \u2014 object-centric Move contracts, parallel execution benefits (high-TPS games, DEXes), zkLogin auth (Google/Apple login \u2192 on-chain identity), sponsored transactions (gasless UX).",
+    "firstSteps": [
+      "Install SDK: `pnpm add @mysten/sui` (TS client) + `@mysten/wallet-kit` (React wallet connection).",
+      "For Move contracts: `sui move new <name>` then edit sources/. Objects-not-accounts mental model \u2014 see https://docs.sui.io/concepts/object-model.",
+      "For zkLogin: `pnpm add @mysten/zklogin`. Users authenticate via OAuth \u2192 zkLogin derives a deterministic Sui address from the JWT + a salt. No seed phrase.",
+      "For sponsored txs: your backend signs the gas, user signs the transaction data. Use `TransactionBlock.setGasPayment()` to specify sponsor coins."
+    ],
+    "gotchas": [
+      "Sui's object model is not Ethereum's account model. You cannot \"just\" port an ERC-20 \u2014 coins are first-class objects with ownership rules.",
+      "zkLogin salts must be managed server-side (one per user) \u2014 expose them client-side and you leak the user's address derivation.",
+      "Move packages are immutable after publish. Plan upgrades via the upgrade-capability pattern (UpgradeCap object) BEFORE shipping v1.",
+      "Testnet + devnet reset periodically \u2014 do not rely on on-chain state persistence during development."
+    ]
+  }
+}

package/registry/partners/tempo/files/tempo-config.json

@@ -0,0 +1,26 @@
+{
+  "partner": "tempo",
+  "focus": "payments + stablecoin settlement + x402 / MPP agent flows",
+  "networks": {
+    "mainnet": {
+      "chainId": "see tempo.xyz/docs",
+      "rpc": "https://rpc.tempo.xyz",
+      "explorer": "https://explorer.tempo.xyz"
+    }
+  },
+  "stablecoins": {
+    "USDC": "primary settlement asset",
+    "USDT": "widely supported"
+  },
+  "archetypes": [
+    "x402 pay-per-request APIs",
+    "agent-to-agent MPP payments",
+    "stablecoin invoicing",
+    "micropayment streaming",
+    "high-frequency settlement dApps"
+  ],
+  "sdk": {
+    "evm": "viem + wagmi — Tempo is EVM-compatible, standard EVM tooling works"
+  },
+  "docs": "https://tempo.xyz/docs"
+}

package/registry/partners/tempo/manifest.json

@@ -0,0 +1,46 @@
+{
+  "id": "tempo",
+  "description": "Partner pack for Tempo \u2014 Paradigm's payments-optimized L1 with sub-second settlement, high throughput, EVM-compatible. Biases toward payments rails, stablecoin-denominated dApps, x402 agent-to-agent flows.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "x402-service",
+    "forge-contracts",
+    "hardhat-contracts",
+    "tangle-blueprint"
+  ],
+  "slotDefaults": {
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Build on Tempo \u2014 payments-speed L1, EVM-compatible",
+    "subheadline": "Sub-second settlement, stablecoin-first. Tuned for x402 agent payments, micropayments, and high-frequency settlement."
+  },
+  "files": [
+    {
+      "source": "files/tempo-config.json",
+      "target": "tempo-config.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Attach for payment-focused dApps + agent economies on Tempo \u2014 sub-second settlement, USDC-native, EVM-compatible. Tuned for x402 pay-per-request APIs, MPP agent-to-agent payments, high-frequency settlement, stablecoin invoicing.",
+    "firstSteps": [
+      "Use standard EVM tooling: `pnpm add viem wagmi`. Tempo is EVM-compatible \u2014 no Tempo-specific SDK needed.",
+      "Point RPC at Tempo: set `VITE_RPC_URL` / equivalent to the mainnet RPC from tempo-config.json. Explorer link is there too.",
+      "USDC is the primary settlement asset. Contract address + decimals live in tempo-config.json; import them instead of hardcoding.",
+      "For x402 integration: x402 headers work unchanged over Tempo. Use capability:tangle-x402 or x402-service family for the scaffolding.",
+      "For MPP agent payments: capability:tangle-mpp pairs with this partner \u2014 delegation + budget caps signed on Tempo."
+    ],
+    "gotchas": [
+      "Tempo is new (2025) \u2014 block explorers + indexers may lag mainnet state by seconds during volume spikes.",
+      "USDC-native means users need USDC on Tempo (not just ETH). Design your UX around a one-time bridge/onramp step.",
+      "Gas is paid in native token (check tempo-config.json). Keep a small native balance for every address that will transact.",
+      "Check chainId on every write-path \u2014 sending a signed tx meant for Tempo to Base (EVM-compatible = same format) is a common user error."
+    ]
+  }
+}

package/registry/partners/tether/files/partner-config.json

@@ -0,0 +1,17 @@
+{
+  "partnerId": "tether",
+  "assetSymbol": "USDT",
+  "decimals": 6,
+  "contracts": {
+    "ethereum": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+    "arbitrum": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+    "avalanche": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
+    "polygon": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+    "bsc": "0x55d398326f99059fF775485246999027B3197955",
+    "optimism": "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58",
+    "solana": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
+    "tron": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
+  },
+  "runtimeFocus": "cross-chain-stablecoin-rail",
+  "preferredOutputs": ["remittance", "merchant-payments", "dollar-denominated-trading"]
+}

package/registry/partners/tether/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "tether",
+  "brandTone": "stablecoin-rail",
+  "primaryColor": "#26A17B"
+}

package/registry/partners/tether/manifest.json

@@ -0,0 +1,49 @@
+{
+  "id": "tether",
+  "description": "Partner pack for Tether (USDT) — largest stablecoin by circulating supply, available on 15+ chains. Biases toward cross-chain payment rails, emerging-market remittance, and USDT-denominated trading surfaces.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "python-api",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "worker-job",
+    "x402-service",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "payments": "payments:stripe",
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Build on USDT — cross-chain stablecoin rails",
+    "subheadline": "USDT is live on Ethereum, Tron, Solana, Arbitrum, Avalanche, Polygon, BSC + more. Tune flows for remittance, merchant payments, and dollar-denominated trading."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions USDT, Tether, stablecoin payments, remittance, or dollar-denominated on-chain commerce.",
+    "firstSteps": [
+      "Pick the chain first, THEN the USDT contract address. Contract addresses in partner-config.json.contracts map by chain — there is no canonical USDT contract across chains.",
+      "For frontend flows, show the chain name alongside the USDT balance — users regularly confuse Tron USDT with Ethereum USDT.",
+      "For merchant/remittance flows, prefer Tron or Arbitrum for sub-cent gas; default to Ethereum only when institutional flows require it."
+    ],
+    "gotchas": [
+      "USDT on Ethereum is NOT a standard ERC-20 — it's missing the bool return on `approve` and `transferFrom`. Use SafeERC20 or viem's `writeContract` which handles this.",
+      "USDT on Tron uses TRC-20 — a completely different chain. Don't assume an Ethereum wallet can send Tron USDT.",
+      "USDT issuance/redemption is permissioned at the Tether-Ltd level. Addresses can be blacklisted — design escrow + treasury flows to handle this."
+    ]
+  }
+}

package/registry/partners/usdc-circle/files/partner-config.json

@@ -0,0 +1,25 @@
+{
+  "partnerId": "usdc-circle",
+  "assetSymbol": "USDC",
+  "decimals": 6,
+  "contracts": {
+    "ethereum": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    "arbitrum": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    "base": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    "optimism": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+    "polygon": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    "avalanche": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+    "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+  },
+  "cctpDomains": {
+    "ethereum": 0,
+    "avalanche": 1,
+    "optimism": 2,
+    "arbitrum": 3,
+    "solana": 5,
+    "base": 6,
+    "polygon": 7
+  },
+  "runtimeFocus": "regulated-cctp-native-stablecoin",
+  "preferredOutputs": ["compliant-payments", "agent-micropayments", "native-cross-chain-transfer"]
+}

package/registry/partners/usdc-circle/files/starter-brand.json

@@ -0,0 +1,5 @@
+{
+  "partner": "usdc-circle",
+  "brandTone": "regulated-stablecoin",
+  "primaryColor": "#2775CA"
+}

package/registry/partners/usdc-circle/manifest.json

@@ -0,0 +1,50 @@
+{
+  "id": "usdc-circle",
+  "description": "Partner pack for Circle USDC — regulated stablecoin with native issuance on 16+ chains via CCTP (Cross-Chain Transfer Protocol). Biases toward compliance-sensitive payments, agent micropayments, and native cross-chain rails.",
+  "appliesTo": [
+    "frontend-static",
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts",
+    "api-service",
+    "python-api",
+    "evm-infra-ts",
+    "agent-service-ts",
+    "agent-service-py",
+    "worker-job",
+    "x402-service",
+    "forge-contracts",
+    "hardhat-contracts"
+  ],
+  "slotDefaults": {
+    "payments": "payments:stripe",
+    "sdk": "sdk:evm-wallet"
+  },
+  "defaults": {
+    "headline": "Build on USDC — regulated stablecoin + CCTP",
+    "subheadline": "Native on 16+ chains. CCTP burn-and-mint for native cross-chain transfers — no wrapped assets, no bridge risk."
+  },
+  "files": [
+    {
+      "source": "files/partner-config.json",
+      "target": "partner-config.json"
+    },
+    {
+      "source": "files/starter-brand.json",
+      "target": "starter-brand.json"
+    }
+  ],
+  "buildHints": {
+    "whenToUse": "Prompt mentions USDC, Circle, regulated stablecoin, CCTP, cross-chain USDC transfer, or compliance-focused payments.",
+    "firstSteps": [
+      "Use the Circle Developer Console to provision API keys if the flow needs fiat on/off-ramp (https://console.circle.com).",
+      "For cross-chain transfers, prefer CCTP (burn on source, attest via Circle API, mint on destination) over any bridge — CCTP gives native USDC everywhere.",
+      "Contract addresses per chain are in partner-config.json.contracts. USDC is a standard ERC-20 — no SafeERC20 shims needed (unlike USDT)."
+    ],
+    "gotchas": [
+      "CCTP requires a Circle-issued attestation before mint on the destination chain. Expect 13-20 minutes on Ethereum mainnet for the attestation to be available.",
+      "USDC on Solana uses SPL Token, not ERC-20 — use the @solana/spl-token SDK.",
+      "Circle can freeze addresses via the USDC contract's blacklist. Treasury flows should detect blacklist state before irrevocable swaps."
+    ]
+  }
+}