Imported from AiFinPay/sdk (deployments/AGENTS.md). Install upstream with npx skills add AiFinPay/sdk --skill deployments. Copyright stays with the author.

@aifinpay/deployments — agent guide

Canonical deployment registry grabber. Fetches the latest AIFP deployment records from upstream contract repositories and produces versioned registry files with governance metadata.

Scope

• This package only (src/, tests/, registry/, package.json). Do not touch node/, python/, mcp/, mcp-http/, wallet/, gate/, skill/.
• Entry: src/index.ts. Core: src/grabber.ts (EVM + Solana fetch + latest-per-chain logic + split-file writer), src/types.ts (registry types), src/build.ts (CLI that writes split files).
• Output artifacts live in registry/:
  • registry/splitter/ — versioned registry with governance metadata:
    • evm/v1.4/deployments.json — EVM v1.4 full contract suite with governance Safe info
    • evm/v1.3/deployments.json — EVM v1.3 route table (merchant-aifp1 + agent-x402)
    • evm/v1.2/deployments.json — EVM v1.2 legacy with paymentId replay guard
    • evm/v1.1/deployments.json — EVM v1.1 initial production release
    • solana/deployments.json — Solana v1.4 program deployments
    • casper/deployments.json — Casper deployments (testnet live, mainnet historical)
    • INDEX.md — registry index with lookup tables by version and chain
  • registry/abi/ — EVM ABI bundles and Tron ABI artifacts.
  • registry/idl/ — Solana IDL copies (solana/splitter-v14/) plus Aptos/Casper IDL artifacts.
• The v1.3 historical snapshot is not regenerated by the grabber (upstream no longer serves those files). Keep it in registry/splitter/evm/v1.3 and refresh manually when node/registry/splitter-table.json changes.

Commands

• npm run build — tsc -p tsconfig.json
• npm run registry:build — node dist/build.js, fetches upstream and writes registry/splitter/evm/v1.4/deployments.json + registry/splitter/solana/deployments.json
• npm test — vitest run (from deployments/)

Rules

• Keep IDL_DIR and ABI paths under registry/ so they ship with the package (files: ["dist", "registry"]).
• Generated deployment files use the same schema across all versions in splitter/*/deployments.json for consistency.
• Tests are offline-only and must not write files to registry/ or src/. Use tests/tmp/ for temporary test output (gitignored).
• Solana IDL files live in registry/idl/solana/splitter-v14/ — do not regenerate them, they are maintained manually.
• Bump version + CHANGELOG.md together when changing shipped files; CI checks via scripts/check-version-bump.mjs.