@cnvlabskoxyz/celina-sdk 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +167 -2
- package/build/a2a/agent-card.d.ts +37 -0
- package/build/a2a/agent-card.js +46 -0
- package/build/a2a/agent-card.js.map +1 -0
- package/build/a2a/index.d.ts +2 -0
- package/build/a2a/index.js +3 -0
- package/build/a2a/index.js.map +1 -0
- package/build/a2a/skills.d.ts +18 -0
- package/build/a2a/skills.js +111 -0
- package/build/a2a/skills.js.map +1 -0
- package/build/aa/create-aa-client.d.ts +44 -0
- package/build/aa/create-aa-client.js +118 -0
- package/build/aa/create-aa-client.js.map +1 -0
- package/build/aa/gas-sponsorship.d.ts +27 -0
- package/build/aa/gas-sponsorship.js +65 -0
- package/build/aa/gas-sponsorship.js.map +1 -0
- package/build/aa/index.d.ts +4 -0
- package/build/aa/index.js +4 -0
- package/build/aa/index.js.map +1 -0
- package/build/aa/prepared-calls.d.ts +8 -0
- package/build/aa/prepared-calls.js +27 -0
- package/build/aa/prepared-calls.js.map +1 -0
- package/build/aa/types.d.ts +61 -0
- package/build/aa/types.js +2 -0
- package/build/aa/types.js.map +1 -0
- package/build/abis/aave-data-provider.d.ts +17 -0
- package/build/abis/aave-data-provider.js +14 -0
- package/build/abis/aave-data-provider.js.map +1 -0
- package/build/abis/aave-pool.d.ts +37 -0
- package/build/abis/aave-pool.js +26 -0
- package/build/abis/aave-pool.js.map +1 -0
- package/build/abis/accounts.d.ts +43 -0
- package/build/abis/accounts.js +31 -0
- package/build/abis/accounts.js.map +1 -0
- package/build/abis/election.d.ts +208 -0
- package/build/abis/election.js +143 -0
- package/build/abis/election.js.map +1 -0
- package/build/abis/gooddollar-broker.d.ts +77 -0
- package/build/abis/gooddollar-broker.js +44 -0
- package/build/abis/gooddollar-broker.js.map +1 -0
- package/build/abis/gooddollar-identity.d.ts +103 -0
- package/build/abis/gooddollar-identity.js +66 -0
- package/build/abis/gooddollar-identity.js.map +1 -0
- package/build/abis/governance.d.ts +243 -0
- package/build/abis/governance.js +188 -0
- package/build/abis/governance.js.map +1 -0
- package/build/abis/locked-gold.d.ts +184 -0
- package/build/abis/locked-gold.js +133 -0
- package/build/abis/locked-gold.js.map +1 -0
- package/build/abis/nft.d.ts +107 -0
- package/build/abis/nft.js +75 -0
- package/build/abis/nft.js.map +1 -0
- package/build/abis/permit2.d.ts +43 -0
- package/build/abis/permit2.js +30 -0
- package/build/abis/permit2.js.map +1 -0
- package/build/abis/self-registry.d.ts +194 -0
- package/build/abis/self-registry.js +120 -0
- package/build/abis/self-registry.js.map +1 -0
- package/build/abis/ubi-scheme.d.ts +91 -0
- package/build/abis/ubi-scheme.js +66 -0
- package/build/abis/ubi-scheme.js.map +1 -0
- package/build/abis/uniswap-state-view.d.ts +34 -0
- package/build/abis/uniswap-state-view.js +22 -0
- package/build/abis/uniswap-state-view.js.map +1 -0
- package/build/abis/uniswap-v3.d.ts +171 -0
- package/build/abis/uniswap-v3.js +120 -0
- package/build/abis/uniswap-v3.js.map +1 -0
- package/build/abis/uniswap-v4-quoter.d.ts +86 -0
- package/build/abis/uniswap-v4-quoter.js +64 -0
- package/build/abis/uniswap-v4-quoter.js.map +1 -0
- package/build/abis/universal-router.d.ts +16 -0
- package/build/abis/universal-router.js +14 -0
- package/build/abis/universal-router.js.map +1 -0
- package/build/abis/validators-minimal.d.ts +65 -0
- package/build/abis/validators-minimal.js +39 -0
- package/build/abis/validators-minimal.js.map +1 -0
- package/build/analytics/config.d.ts +4 -0
- package/build/analytics/config.js +9 -0
- package/build/analytics/config.js.map +1 -0
- package/build/analytics/consumer-package.d.ts +9 -0
- package/build/analytics/consumer-package.js +147 -0
- package/build/analytics/consumer-package.js.map +1 -0
- package/build/analytics/events-stats.d.ts +19 -0
- package/build/analytics/events-stats.js +92 -0
- package/build/analytics/events-stats.js.map +1 -0
- package/build/analytics/mcp-tool-events.d.ts +5 -0
- package/build/analytics/mcp-tool-events.js +67 -0
- package/build/analytics/mcp-tool-events.js.map +1 -0
- package/build/analytics/onchain-stats.d.ts +17 -0
- package/build/analytics/onchain-stats.js +66 -0
- package/build/analytics/onchain-stats.js.map +1 -0
- package/build/analytics/wallet-context.d.ts +11 -0
- package/build/analytics/wallet-context.js +81 -0
- package/build/analytics/wallet-context.js.map +1 -0
- package/build/analytics/wallet-extract.d.ts +9 -0
- package/build/analytics/wallet-extract.js +29 -0
- package/build/analytics/wallet-extract.js.map +1 -0
- package/build/analytics/wrap-service.d.ts +6 -0
- package/build/analytics/wrap-service.js +55 -0
- package/build/analytics/wrap-service.js.map +1 -0
- package/build/clients/celo-client.d.ts +19 -0
- package/build/clients/celo-client.js +40 -0
- package/build/clients/celo-client.js.map +1 -0
- package/build/clients/citizen-sdk.d.ts +1 -0
- package/build/clients/citizen-sdk.js +2 -0
- package/build/clients/citizen-sdk.js.map +1 -0
- package/build/clients/ens-client.d.ts +17 -0
- package/build/clients/ens-client.js +30 -0
- package/build/clients/ens-client.js.map +1 -0
- package/build/clients/generated/citizen-sdk.bundle.js +1133 -0
- package/build/clients/generated/mento-sdk.bundle.js +20343 -0
- package/build/clients/generated/uniswap-sdk.bundle.js +29715 -0
- package/build/clients/mento-sdk.d.ts +2 -0
- package/build/clients/mento-sdk.js +2 -0
- package/build/clients/mento-sdk.js.map +1 -0
- package/build/clients/self-api.d.ts +83 -0
- package/build/clients/self-api.js +242 -0
- package/build/clients/self-api.js.map +1 -0
- package/build/clients/uniswap-sdk.d.ts +4 -0
- package/build/clients/uniswap-sdk.js +4 -0
- package/build/clients/uniswap-sdk.js.map +1 -0
- package/build/config/aave.d.ts +19 -0
- package/build/config/aave.js +79 -0
- package/build/config/aave.js.map +1 -0
- package/build/config/celina-tag.d.ts +48 -0
- package/build/config/celina-tag.js +193 -0
- package/build/config/celina-tag.js.map +1 -0
- package/build/config/celo-core-contracts.d.ts +8 -0
- package/build/config/celo-core-contracts.js +9 -0
- package/build/config/celo-core-contracts.js.map +1 -0
- package/build/config/chains.d.ts +937 -0
- package/build/config/chains.js +327 -0
- package/build/config/chains.js.map +1 -0
- package/build/config/gooddollar.d.ts +18 -0
- package/build/config/gooddollar.js +26 -0
- package/build/config/gooddollar.js.map +1 -0
- package/build/config/sdk-config.d.ts +44 -0
- package/build/config/sdk-config.js +33 -0
- package/build/config/sdk-config.js.map +1 -0
- package/build/config/self.d.ts +24 -0
- package/build/config/self.js +29 -0
- package/build/config/self.js.map +1 -0
- package/build/config/uniswap.d.ts +57 -0
- package/build/config/uniswap.js +84 -0
- package/build/config/uniswap.js.map +1 -0
- package/build/index.d.ts +148 -0
- package/build/index.js +89 -0
- package/build/index.js.map +1 -0
- package/build/oasf/index.d.ts +2 -0
- package/build/oasf/index.js +3 -0
- package/build/oasf/index.js.map +1 -0
- package/build/oasf/record.d.ts +39 -0
- package/build/oasf/record.js +35 -0
- package/build/oasf/record.js.map +1 -0
- package/build/oasf/taxonomy.d.ts +19 -0
- package/build/oasf/taxonomy.js +46 -0
- package/build/oasf/taxonomy.js.map +1 -0
- package/build/services/aave.service.d.ts +66 -0
- package/build/services/aave.service.js +240 -0
- package/build/services/aave.service.js.map +1 -0
- package/build/services/account.service.d.ts +36 -0
- package/build/services/account.service.js +91 -0
- package/build/services/account.service.js.map +1 -0
- package/build/services/agentkarma.service.d.ts +89 -0
- package/build/services/agentkarma.service.js +102 -0
- package/build/services/agentkarma.service.js.map +1 -0
- package/build/services/blockchain.service.d.ts +126 -0
- package/build/services/blockchain.service.js +188 -0
- package/build/services/blockchain.service.js.map +1 -0
- package/build/services/contract.service.d.ts +88 -0
- package/build/services/contract.service.js +163 -0
- package/build/services/contract.service.js.map +1 -0
- package/build/services/ens.service.d.ts +44 -0
- package/build/services/ens.service.js +92 -0
- package/build/services/ens.service.js.map +1 -0
- package/build/services/gooddollar-identity-guidance.d.ts +24 -0
- package/build/services/gooddollar-identity-guidance.js +51 -0
- package/build/services/gooddollar-identity-guidance.js.map +1 -0
- package/build/services/gooddollar.service.d.ts +232 -0
- package/build/services/gooddollar.service.js +805 -0
- package/build/services/gooddollar.service.js.map +1 -0
- package/build/services/governance-delegates.d.ts +105 -0
- package/build/services/governance-delegates.js +226 -0
- package/build/services/governance-delegates.js.map +1 -0
- package/build/services/governance.service.d.ts +259 -0
- package/build/services/governance.service.js +987 -0
- package/build/services/governance.service.js.map +1 -0
- package/build/services/humanness.service.d.ts +32 -0
- package/build/services/humanness.service.js +131 -0
- package/build/services/humanness.service.js.map +1 -0
- package/build/services/mento-fx.service.d.ts +88 -0
- package/build/services/mento-fx.service.js +336 -0
- package/build/services/mento-fx.service.js.map +1 -0
- package/build/services/nft.service.d.ts +58 -0
- package/build/services/nft.service.js +222 -0
- package/build/services/nft.service.js.map +1 -0
- package/build/services/self-session-store.d.ts +19 -0
- package/build/services/self-session-store.js +28 -0
- package/build/services/self-session-store.js.map +1 -0
- package/build/services/self.service.d.ts +260 -0
- package/build/services/self.service.js +710 -0
- package/build/services/self.service.js.map +1 -0
- package/build/services/staking.service.d.ts +199 -0
- package/build/services/staking.service.js +827 -0
- package/build/services/staking.service.js.map +1 -0
- package/build/services/swap-pairs.d.ts +57 -0
- package/build/services/swap-pairs.js +159 -0
- package/build/services/swap-pairs.js.map +1 -0
- package/build/services/token.service.d.ts +110 -0
- package/build/services/token.service.js +189 -0
- package/build/services/token.service.js.map +1 -0
- package/build/services/transaction.service.d.ts +69 -0
- package/build/services/transaction.service.js +197 -0
- package/build/services/transaction.service.js.map +1 -0
- package/build/services/uniswap-path-router.d.ts +59 -0
- package/build/services/uniswap-path-router.js +210 -0
- package/build/services/uniswap-path-router.js.map +1 -0
- package/build/services/uniswap-pool-discovery.d.ts +55 -0
- package/build/services/uniswap-pool-discovery.js +243 -0
- package/build/services/uniswap-pool-discovery.js.map +1 -0
- package/build/services/uniswap-v3-path-router.d.ts +40 -0
- package/build/services/uniswap-v3-path-router.js +183 -0
- package/build/services/uniswap-v3-path-router.js.map +1 -0
- package/build/services/uniswap-v3-pool-discovery.d.ts +33 -0
- package/build/services/uniswap-v3-pool-discovery.js +141 -0
- package/build/services/uniswap-v3-pool-discovery.js.map +1 -0
- package/build/services/uniswap-venue-quote.d.ts +28 -0
- package/build/services/uniswap-venue-quote.js +114 -0
- package/build/services/uniswap-venue-quote.js.map +1 -0
- package/build/services/uniswap.service.d.ts +104 -0
- package/build/services/uniswap.service.js +419 -0
- package/build/services/uniswap.service.js.map +1 -0
- package/build/simulation/index.d.ts +5 -0
- package/build/simulation/index.js +2 -0
- package/build/simulation/index.js.map +1 -0
- package/build/simulation/simulate-prepared-step.d.ts +37 -0
- package/build/simulation/simulate-prepared-step.js +89 -0
- package/build/simulation/simulate-prepared-step.js.map +1 -0
- package/build/src/a2a/agent-card.d.ts +37 -0
- package/build/src/a2a/agent-card.js +46 -0
- package/build/src/a2a/agent-card.js.map +1 -0
- package/build/src/a2a/index.d.ts +2 -0
- package/build/src/a2a/index.js +3 -0
- package/build/src/a2a/index.js.map +1 -0
- package/build/src/a2a/skills.d.ts +18 -0
- package/build/src/a2a/skills.js +111 -0
- package/build/src/a2a/skills.js.map +1 -0
- package/build/src/aa/create-aa-client.d.ts +44 -0
- package/build/src/aa/create-aa-client.js +118 -0
- package/build/src/aa/create-aa-client.js.map +1 -0
- package/build/src/aa/gas-sponsorship.d.ts +27 -0
- package/build/src/aa/gas-sponsorship.js +65 -0
- package/build/src/aa/gas-sponsorship.js.map +1 -0
- package/build/src/aa/index.d.ts +4 -0
- package/build/src/aa/index.js +4 -0
- package/build/src/aa/index.js.map +1 -0
- package/build/src/aa/prepared-calls.d.ts +8 -0
- package/build/src/aa/prepared-calls.js +27 -0
- package/build/src/aa/prepared-calls.js.map +1 -0
- package/build/src/aa/types.d.ts +61 -0
- package/build/src/aa/types.js +2 -0
- package/build/src/aa/types.js.map +1 -0
- package/build/src/abis/aave-data-provider.d.ts +17 -0
- package/build/src/abis/aave-data-provider.js +14 -0
- package/build/src/abis/aave-data-provider.js.map +1 -0
- package/build/src/abis/aave-pool.d.ts +37 -0
- package/build/src/abis/aave-pool.js +26 -0
- package/build/src/abis/aave-pool.js.map +1 -0
- package/build/src/abis/accounts.d.ts +43 -0
- package/build/src/abis/accounts.js +31 -0
- package/build/src/abis/accounts.js.map +1 -0
- package/build/src/abis/election.d.ts +208 -0
- package/build/src/abis/election.js +143 -0
- package/build/src/abis/election.js.map +1 -0
- package/build/src/abis/gooddollar-broker.d.ts +77 -0
- package/build/src/abis/gooddollar-broker.js +44 -0
- package/build/src/abis/gooddollar-broker.js.map +1 -0
- package/build/src/abis/gooddollar-identity.d.ts +103 -0
- package/build/src/abis/gooddollar-identity.js +66 -0
- package/build/src/abis/gooddollar-identity.js.map +1 -0
- package/build/src/abis/governance.d.ts +243 -0
- package/build/src/abis/governance.js +188 -0
- package/build/src/abis/governance.js.map +1 -0
- package/build/src/abis/locked-gold.d.ts +184 -0
- package/build/src/abis/locked-gold.js +133 -0
- package/build/src/abis/locked-gold.js.map +1 -0
- package/build/src/abis/nft.d.ts +107 -0
- package/build/src/abis/nft.js +75 -0
- package/build/src/abis/nft.js.map +1 -0
- package/build/src/abis/permit2.d.ts +43 -0
- package/build/src/abis/permit2.js +30 -0
- package/build/src/abis/permit2.js.map +1 -0
- package/build/src/abis/self-registry.d.ts +194 -0
- package/build/src/abis/self-registry.js +120 -0
- package/build/src/abis/self-registry.js.map +1 -0
- package/build/src/abis/ubi-scheme.d.ts +91 -0
- package/build/src/abis/ubi-scheme.js +66 -0
- package/build/src/abis/ubi-scheme.js.map +1 -0
- package/build/src/abis/uniswap-state-view.d.ts +34 -0
- package/build/src/abis/uniswap-state-view.js +22 -0
- package/build/src/abis/uniswap-state-view.js.map +1 -0
- package/build/src/abis/uniswap-v3.d.ts +171 -0
- package/build/src/abis/uniswap-v3.js +120 -0
- package/build/src/abis/uniswap-v3.js.map +1 -0
- package/build/src/abis/uniswap-v4-quoter.d.ts +86 -0
- package/build/src/abis/uniswap-v4-quoter.js +64 -0
- package/build/src/abis/uniswap-v4-quoter.js.map +1 -0
- package/build/src/abis/universal-router.d.ts +16 -0
- package/build/src/abis/universal-router.js +14 -0
- package/build/src/abis/universal-router.js.map +1 -0
- package/build/src/abis/validators-minimal.d.ts +65 -0
- package/build/src/abis/validators-minimal.js +39 -0
- package/build/src/abis/validators-minimal.js.map +1 -0
- package/build/src/analytics/config.d.ts +4 -0
- package/build/src/analytics/config.js +9 -0
- package/build/src/analytics/config.js.map +1 -0
- package/build/src/analytics/consumer-package.d.ts +9 -0
- package/build/src/analytics/consumer-package.js +147 -0
- package/build/src/analytics/consumer-package.js.map +1 -0
- package/build/src/analytics/events-stats.d.ts +19 -0
- package/build/src/analytics/events-stats.js +92 -0
- package/build/src/analytics/events-stats.js.map +1 -0
- package/build/src/analytics/mcp-tool-events.d.ts +5 -0
- package/build/src/analytics/mcp-tool-events.js +67 -0
- package/build/src/analytics/mcp-tool-events.js.map +1 -0
- package/build/src/analytics/onchain-stats.d.ts +17 -0
- package/build/src/analytics/onchain-stats.js +66 -0
- package/build/src/analytics/onchain-stats.js.map +1 -0
- package/build/src/analytics/wallet-context.d.ts +11 -0
- package/build/src/analytics/wallet-context.js +81 -0
- package/build/src/analytics/wallet-context.js.map +1 -0
- package/build/src/analytics/wallet-extract.d.ts +9 -0
- package/build/src/analytics/wallet-extract.js +29 -0
- package/build/src/analytics/wallet-extract.js.map +1 -0
- package/build/src/analytics/wrap-service.d.ts +6 -0
- package/build/src/analytics/wrap-service.js +55 -0
- package/build/src/analytics/wrap-service.js.map +1 -0
- package/build/src/clients/celo-client.d.ts +19 -0
- package/build/src/clients/celo-client.js +40 -0
- package/build/src/clients/celo-client.js.map +1 -0
- package/build/src/clients/citizen-sdk.d.ts +1 -0
- package/build/src/clients/citizen-sdk.js +2 -0
- package/build/src/clients/citizen-sdk.js.map +1 -0
- package/build/src/clients/ens-client.d.ts +17 -0
- package/build/src/clients/ens-client.js +30 -0
- package/build/src/clients/ens-client.js.map +1 -0
- package/build/src/clients/mento-sdk.d.ts +2 -0
- package/build/src/clients/mento-sdk.js +2 -0
- package/build/src/clients/mento-sdk.js.map +1 -0
- package/build/src/clients/self-api.d.ts +83 -0
- package/build/src/clients/self-api.js +242 -0
- package/build/src/clients/self-api.js.map +1 -0
- package/build/src/clients/uniswap-sdk.d.ts +4 -0
- package/build/src/clients/uniswap-sdk.js +4 -0
- package/build/src/clients/uniswap-sdk.js.map +1 -0
- package/build/src/config/aave.d.ts +19 -0
- package/build/src/config/aave.js +79 -0
- package/build/src/config/aave.js.map +1 -0
- package/build/src/config/celina-tag.d.ts +48 -0
- package/build/src/config/celina-tag.js +193 -0
- package/build/src/config/celina-tag.js.map +1 -0
- package/build/src/config/celo-core-contracts.d.ts +8 -0
- package/build/src/config/celo-core-contracts.js +9 -0
- package/build/src/config/celo-core-contracts.js.map +1 -0
- package/build/src/config/chains.d.ts +937 -0
- package/build/src/config/chains.js +327 -0
- package/build/src/config/chains.js.map +1 -0
- package/build/src/config/gooddollar.d.ts +18 -0
- package/build/src/config/gooddollar.js +26 -0
- package/build/src/config/gooddollar.js.map +1 -0
- package/build/src/config/sdk-config.d.ts +44 -0
- package/build/src/config/sdk-config.js +33 -0
- package/build/src/config/sdk-config.js.map +1 -0
- package/build/src/config/self.d.ts +24 -0
- package/build/src/config/self.js +29 -0
- package/build/src/config/self.js.map +1 -0
- package/build/src/config/uniswap.d.ts +57 -0
- package/build/src/config/uniswap.js +84 -0
- package/build/src/config/uniswap.js.map +1 -0
- package/build/src/index.d.ts +148 -0
- package/build/src/index.js +89 -0
- package/build/src/index.js.map +1 -0
- package/build/src/oasf/index.d.ts +2 -0
- package/build/src/oasf/index.js +3 -0
- package/build/src/oasf/index.js.map +1 -0
- package/build/src/oasf/record.d.ts +39 -0
- package/build/src/oasf/record.js +35 -0
- package/build/src/oasf/record.js.map +1 -0
- package/build/src/oasf/taxonomy.d.ts +19 -0
- package/build/src/oasf/taxonomy.js +46 -0
- package/build/src/oasf/taxonomy.js.map +1 -0
- package/build/src/services/aave.service.d.ts +66 -0
- package/build/src/services/aave.service.js +240 -0
- package/build/src/services/aave.service.js.map +1 -0
- package/build/src/services/account.service.d.ts +36 -0
- package/build/src/services/account.service.js +91 -0
- package/build/src/services/account.service.js.map +1 -0
- package/build/src/services/agentkarma.service.d.ts +89 -0
- package/build/src/services/agentkarma.service.js +102 -0
- package/build/src/services/agentkarma.service.js.map +1 -0
- package/build/src/services/blockchain.service.d.ts +126 -0
- package/build/src/services/blockchain.service.js +188 -0
- package/build/src/services/blockchain.service.js.map +1 -0
- package/build/src/services/contract.service.d.ts +88 -0
- package/build/src/services/contract.service.js +163 -0
- package/build/src/services/contract.service.js.map +1 -0
- package/build/src/services/ens.service.d.ts +44 -0
- package/build/src/services/ens.service.js +92 -0
- package/build/src/services/ens.service.js.map +1 -0
- package/build/src/services/gooddollar-identity-guidance.d.ts +24 -0
- package/build/src/services/gooddollar-identity-guidance.js +51 -0
- package/build/src/services/gooddollar-identity-guidance.js.map +1 -0
- package/build/src/services/gooddollar.service.d.ts +232 -0
- package/build/src/services/gooddollar.service.js +805 -0
- package/build/src/services/gooddollar.service.js.map +1 -0
- package/build/src/services/governance-delegates.d.ts +105 -0
- package/build/src/services/governance-delegates.js +226 -0
- package/build/src/services/governance-delegates.js.map +1 -0
- package/build/src/services/governance.service.d.ts +259 -0
- package/build/src/services/governance.service.js +987 -0
- package/build/src/services/governance.service.js.map +1 -0
- package/build/src/services/humanness.service.d.ts +32 -0
- package/build/src/services/humanness.service.js +131 -0
- package/build/src/services/humanness.service.js.map +1 -0
- package/build/src/services/mento-fx.service.d.ts +88 -0
- package/build/src/services/mento-fx.service.js +336 -0
- package/build/src/services/mento-fx.service.js.map +1 -0
- package/build/src/services/nft.service.d.ts +58 -0
- package/build/src/services/nft.service.js +222 -0
- package/build/src/services/nft.service.js.map +1 -0
- package/build/src/services/self-session-store.d.ts +19 -0
- package/build/src/services/self-session-store.js +28 -0
- package/build/src/services/self-session-store.js.map +1 -0
- package/build/src/services/self.service.d.ts +260 -0
- package/build/src/services/self.service.js +710 -0
- package/build/src/services/self.service.js.map +1 -0
- package/build/src/services/staking.service.d.ts +199 -0
- package/build/src/services/staking.service.js +827 -0
- package/build/src/services/staking.service.js.map +1 -0
- package/build/src/services/swap-pairs.d.ts +57 -0
- package/build/src/services/swap-pairs.js +159 -0
- package/build/src/services/swap-pairs.js.map +1 -0
- package/build/src/services/token.service.d.ts +110 -0
- package/build/src/services/token.service.js +189 -0
- package/build/src/services/token.service.js.map +1 -0
- package/build/src/services/transaction.service.d.ts +69 -0
- package/build/src/services/transaction.service.js +197 -0
- package/build/src/services/transaction.service.js.map +1 -0
- package/build/src/services/uniswap-path-router.d.ts +59 -0
- package/build/src/services/uniswap-path-router.js +210 -0
- package/build/src/services/uniswap-path-router.js.map +1 -0
- package/build/src/services/uniswap-pool-discovery.d.ts +55 -0
- package/build/src/services/uniswap-pool-discovery.js +243 -0
- package/build/src/services/uniswap-pool-discovery.js.map +1 -0
- package/build/src/services/uniswap-v3-path-router.d.ts +40 -0
- package/build/src/services/uniswap-v3-path-router.js +183 -0
- package/build/src/services/uniswap-v3-path-router.js.map +1 -0
- package/build/src/services/uniswap-v3-pool-discovery.d.ts +33 -0
- package/build/src/services/uniswap-v3-pool-discovery.js +141 -0
- package/build/src/services/uniswap-v3-pool-discovery.js.map +1 -0
- package/build/src/services/uniswap-venue-quote.d.ts +28 -0
- package/build/src/services/uniswap-venue-quote.js +114 -0
- package/build/src/services/uniswap-venue-quote.js.map +1 -0
- package/build/src/services/uniswap.service.d.ts +104 -0
- package/build/src/services/uniswap.service.js +419 -0
- package/build/src/services/uniswap.service.js.map +1 -0
- package/build/src/simulation/index.d.ts +5 -0
- package/build/src/simulation/index.js +2 -0
- package/build/src/simulation/index.js.map +1 -0
- package/build/src/simulation/simulate-prepared-step.d.ts +37 -0
- package/build/src/simulation/simulate-prepared-step.js +89 -0
- package/build/src/simulation/simulate-prepared-step.js.map +1 -0
- package/build/src/tools/catalog.d.ts +11 -0
- package/build/src/tools/catalog.js +43 -0
- package/build/src/tools/catalog.js.map +1 -0
- package/build/src/tools/domains/aave.d.ts +2 -0
- package/build/src/tools/domains/aave.js +115 -0
- package/build/src/tools/domains/aave.js.map +1 -0
- package/build/src/tools/domains/agentkarma.d.ts +2 -0
- package/build/src/tools/domains/agentkarma.js +92 -0
- package/build/src/tools/domains/agentkarma.js.map +1 -0
- package/build/src/tools/domains/blockchain.d.ts +2 -0
- package/build/src/tools/domains/blockchain.js +195 -0
- package/build/src/tools/domains/blockchain.js.map +1 -0
- package/build/src/tools/domains/browser.d.ts +2 -0
- package/build/src/tools/domains/browser.js +47 -0
- package/build/src/tools/domains/browser.js.map +1 -0
- package/build/src/tools/domains/contract.d.ts +2 -0
- package/build/src/tools/domains/contract.js +119 -0
- package/build/src/tools/domains/contract.js.map +1 -0
- package/build/src/tools/domains/ens.d.ts +2 -0
- package/build/src/tools/domains/ens.js +16 -0
- package/build/src/tools/domains/ens.js.map +1 -0
- package/build/src/tools/domains/gooddollar.d.ts +2 -0
- package/build/src/tools/domains/gooddollar.js +269 -0
- package/build/src/tools/domains/gooddollar.js.map +1 -0
- package/build/src/tools/domains/governance.d.ts +2 -0
- package/build/src/tools/domains/governance.js +419 -0
- package/build/src/tools/domains/governance.js.map +1 -0
- package/build/src/tools/domains/humanness.d.ts +2 -0
- package/build/src/tools/domains/humanness.js +25 -0
- package/build/src/tools/domains/humanness.js.map +1 -0
- package/build/src/tools/domains/index.d.ts +1 -0
- package/build/src/tools/domains/index.js +35 -0
- package/build/src/tools/domains/index.js.map +1 -0
- package/build/src/tools/domains/mento-fx.d.ts +2 -0
- package/build/src/tools/domains/mento-fx.js +82 -0
- package/build/src/tools/domains/mento-fx.js.map +1 -0
- package/build/src/tools/domains/nft.d.ts +2 -0
- package/build/src/tools/domains/nft.js +38 -0
- package/build/src/tools/domains/nft.js.map +1 -0
- package/build/src/tools/domains/self.d.ts +2 -0
- package/build/src/tools/domains/self.js +213 -0
- package/build/src/tools/domains/self.js.map +1 -0
- package/build/src/tools/domains/staking.d.ts +2 -0
- package/build/src/tools/domains/staking.js +340 -0
- package/build/src/tools/domains/staking.js.map +1 -0
- package/build/src/tools/domains/token.d.ts +2 -0
- package/build/src/tools/domains/token.js +74 -0
- package/build/src/tools/domains/token.js.map +1 -0
- package/build/src/tools/domains/transaction.d.ts +2 -0
- package/build/src/tools/domains/transaction.js +124 -0
- package/build/src/tools/domains/transaction.js.map +1 -0
- package/build/src/tools/domains/uniswap.d.ts +2 -0
- package/build/src/tools/domains/uniswap.js +82 -0
- package/build/src/tools/domains/uniswap.js.map +1 -0
- package/build/src/tools/filter.d.ts +2 -0
- package/build/src/tools/filter.js +50 -0
- package/build/src/tools/filter.js.map +1 -0
- package/build/src/tools/index.d.ts +7 -0
- package/build/src/tools/index.js +7 -0
- package/build/src/tools/index.js.map +1 -0
- package/build/src/tools/schemas/common.d.ts +168 -0
- package/build/src/tools/schemas/common.js +216 -0
- package/build/src/tools/schemas/common.js.map +1 -0
- package/build/src/tools/schemas/wallet-params.d.ts +9 -0
- package/build/src/tools/schemas/wallet-params.js +52 -0
- package/build/src/tools/schemas/wallet-params.js.map +1 -0
- package/build/src/tools/swap-routing.d.ts +25 -0
- package/build/src/tools/swap-routing.js +189 -0
- package/build/src/tools/swap-routing.js.map +1 -0
- package/build/src/tools/types.d.ts +186 -0
- package/build/src/tools/types.js +2 -0
- package/build/src/tools/types.js.map +1 -0
- package/build/src/tools/utils/normalize-token.d.ts +2 -0
- package/build/src/tools/utils/normalize-token.js +12 -0
- package/build/src/tools/utils/normalize-token.js.map +1 -0
- package/build/src/tools/utils/wallet.d.ts +4 -0
- package/build/src/tools/utils/wallet.js +8 -0
- package/build/src/tools/utils/wallet.js.map +1 -0
- package/build/src/tools/website-sync.d.ts +28 -0
- package/build/src/tools/website-sync.js +294 -0
- package/build/src/tools/website-sync.js.map +1 -0
- package/build/src/types/prepared.d.ts +43 -0
- package/build/src/types/prepared.js +15 -0
- package/build/src/types/prepared.js.map +1 -0
- package/build/src/utils/celo-account.d.ts +3 -0
- package/build/src/utils/celo-account.js +22 -0
- package/build/src/utils/celo-account.js.map +1 -0
- package/build/src/utils/celo-format.d.ts +6 -0
- package/build/src/utils/celo-format.js +17 -0
- package/build/src/utils/celo-format.js.map +1 -0
- package/build/src/utils/election-vote-neighbors.d.ts +12 -0
- package/build/src/utils/election-vote-neighbors.js +27 -0
- package/build/src/utils/election-vote-neighbors.js.map +1 -0
- package/build/src/utils/erc20-allowance-storage.d.ts +20 -0
- package/build/src/utils/erc20-allowance-storage.js +64 -0
- package/build/src/utils/erc20-allowance-storage.js.map +1 -0
- package/build/src/utils/fixidity.d.ts +11 -0
- package/build/src/utils/fixidity.js +24 -0
- package/build/src/utils/fixidity.js.map +1 -0
- package/build/src/utils/format-date.d.ts +2 -0
- package/build/src/utils/format-date.js +13 -0
- package/build/src/utils/format-date.js.map +1 -0
- package/build/src/utils/format-duration.d.ts +2 -0
- package/build/src/utils/format-duration.js +17 -0
- package/build/src/utils/format-duration.js.map +1 -0
- package/build/src/utils/format-unix-datetime.d.ts +4 -0
- package/build/src/utils/format-unix-datetime.js +18 -0
- package/build/src/utils/format-unix-datetime.js.map +1 -0
- package/build/src/utils/gooddollar-ubi-period.d.ts +23 -0
- package/build/src/utils/gooddollar-ubi-period.js +23 -0
- package/build/src/utils/gooddollar-ubi-period.js.map +1 -0
- package/build/src/utils/governance-queue.d.ts +28 -0
- package/build/src/utils/governance-queue.js +60 -0
- package/build/src/utils/governance-queue.js.map +1 -0
- package/build/src/utils/normalize-address.d.ts +7 -0
- package/build/src/utils/normalize-address.js +16 -0
- package/build/src/utils/normalize-address.js.map +1 -0
- package/build/src/utils/normalize-private-key.d.ts +17 -0
- package/build/src/utils/normalize-private-key.js +37 -0
- package/build/src/utils/normalize-private-key.js.map +1 -0
- package/build/src/utils/self-format.d.ts +73 -0
- package/build/src/utils/self-format.js +134 -0
- package/build/src/utils/self-format.js.map +1 -0
- package/build/src/utils/self-signing.d.ts +4 -0
- package/build/src/utils/self-signing.js +38 -0
- package/build/src/utils/self-signing.js.map +1 -0
- package/build/src/utils/stake-eligibility.d.ts +38 -0
- package/build/src/utils/stake-eligibility.js +55 -0
- package/build/src/utils/stake-eligibility.js.map +1 -0
- package/build/src/utils/transaction-errors.d.ts +3 -0
- package/build/src/utils/transaction-errors.js +17 -0
- package/build/src/utils/transaction-errors.js.map +1 -0
- package/build/tests/catalog/domains/blockchain.d.ts +2 -0
- package/build/tests/catalog/domains/blockchain.js +127 -0
- package/build/tests/catalog/domains/blockchain.js.map +1 -0
- package/build/tests/catalog/domains/chain-ext.d.ts +5 -0
- package/build/tests/catalog/domains/chain-ext.js +595 -0
- package/build/tests/catalog/domains/chain-ext.js.map +1 -0
- package/build/tests/catalog/domains/defi.d.ts +6 -0
- package/build/tests/catalog/domains/defi.js +645 -0
- package/build/tests/catalog/domains/defi.js.map +1 -0
- package/build/tests/catalog/domains/self.d.ts +2 -0
- package/build/tests/catalog/domains/self.js +208 -0
- package/build/tests/catalog/domains/self.js.map +1 -0
- package/build/tests/catalog/domains/token.d.ts +2 -0
- package/build/tests/catalog/domains/token.js +70 -0
- package/build/tests/catalog/domains/token.js.map +1 -0
- package/build/tests/catalog/domains/transaction.d.ts +2 -0
- package/build/tests/catalog/domains/transaction.js +96 -0
- package/build/tests/catalog/domains/transaction.js.map +1 -0
- package/build/tests/catalog/index.d.ts +2 -0
- package/build/tests/catalog/index.js +2 -0
- package/build/tests/catalog/index.js.map +1 -0
- package/build/tests/catalog/operations.d.ts +12 -0
- package/build/tests/catalog/operations.js +29 -0
- package/build/tests/catalog/operations.js.map +1 -0
- package/build/tests/catalog/types.d.ts +24 -0
- package/build/tests/catalog/types.js +2 -0
- package/build/tests/catalog/types.js.map +1 -0
- package/build/tests/fixtures/mainnet.d.ts +54 -0
- package/build/tests/fixtures/mainnet.js +53 -0
- package/build/tests/fixtures/mainnet.js.map +1 -0
- package/build/tests/helpers/assert.d.ts +4 -0
- package/build/tests/helpers/assert.js +24 -0
- package/build/tests/helpers/assert.js.map +1 -0
- package/build/tests/helpers/env.d.ts +11 -0
- package/build/tests/helpers/env.js +28 -0
- package/build/tests/helpers/env.js.map +1 -0
- package/build/tests/helpers/gating.d.ts +3 -0
- package/build/tests/helpers/gating.js +23 -0
- package/build/tests/helpers/gating.js.map +1 -0
- package/build/tests/testing-entry.d.ts +6 -0
- package/build/tests/testing-entry.js +6 -0
- package/build/tests/testing-entry.js.map +1 -0
- package/build/tools/catalog.d.ts +11 -0
- package/build/tools/catalog.js +43 -0
- package/build/tools/catalog.js.map +1 -0
- package/build/tools/domains/aave.d.ts +2 -0
- package/build/tools/domains/aave.js +115 -0
- package/build/tools/domains/aave.js.map +1 -0
- package/build/tools/domains/agentkarma.d.ts +2 -0
- package/build/tools/domains/agentkarma.js +92 -0
- package/build/tools/domains/agentkarma.js.map +1 -0
- package/build/tools/domains/blockchain.d.ts +2 -0
- package/build/tools/domains/blockchain.js +195 -0
- package/build/tools/domains/blockchain.js.map +1 -0
- package/build/tools/domains/browser.d.ts +2 -0
- package/build/tools/domains/browser.js +47 -0
- package/build/tools/domains/browser.js.map +1 -0
- package/build/tools/domains/contract.d.ts +2 -0
- package/build/tools/domains/contract.js +119 -0
- package/build/tools/domains/contract.js.map +1 -0
- package/build/tools/domains/ens.d.ts +2 -0
- package/build/tools/domains/ens.js +16 -0
- package/build/tools/domains/ens.js.map +1 -0
- package/build/tools/domains/gooddollar.d.ts +2 -0
- package/build/tools/domains/gooddollar.js +269 -0
- package/build/tools/domains/gooddollar.js.map +1 -0
- package/build/tools/domains/governance.d.ts +2 -0
- package/build/tools/domains/governance.js +419 -0
- package/build/tools/domains/governance.js.map +1 -0
- package/build/tools/domains/humanness.d.ts +2 -0
- package/build/tools/domains/humanness.js +25 -0
- package/build/tools/domains/humanness.js.map +1 -0
- package/build/tools/domains/index.d.ts +1 -0
- package/build/tools/domains/index.js +35 -0
- package/build/tools/domains/index.js.map +1 -0
- package/build/tools/domains/mento-fx.d.ts +2 -0
- package/build/tools/domains/mento-fx.js +82 -0
- package/build/tools/domains/mento-fx.js.map +1 -0
- package/build/tools/domains/nft.d.ts +2 -0
- package/build/tools/domains/nft.js +38 -0
- package/build/tools/domains/nft.js.map +1 -0
- package/build/tools/domains/self.d.ts +2 -0
- package/build/tools/domains/self.js +213 -0
- package/build/tools/domains/self.js.map +1 -0
- package/build/tools/domains/staking.d.ts +2 -0
- package/build/tools/domains/staking.js +340 -0
- package/build/tools/domains/staking.js.map +1 -0
- package/build/tools/domains/token.d.ts +2 -0
- package/build/tools/domains/token.js +74 -0
- package/build/tools/domains/token.js.map +1 -0
- package/build/tools/domains/transaction.d.ts +2 -0
- package/build/tools/domains/transaction.js +124 -0
- package/build/tools/domains/transaction.js.map +1 -0
- package/build/tools/domains/uniswap.d.ts +2 -0
- package/build/tools/domains/uniswap.js +82 -0
- package/build/tools/domains/uniswap.js.map +1 -0
- package/build/tools/filter.d.ts +2 -0
- package/build/tools/filter.js +50 -0
- package/build/tools/filter.js.map +1 -0
- package/build/tools/index.d.ts +7 -0
- package/build/tools/index.js +7 -0
- package/build/tools/index.js.map +1 -0
- package/build/tools/schemas/common.d.ts +168 -0
- package/build/tools/schemas/common.js +216 -0
- package/build/tools/schemas/common.js.map +1 -0
- package/build/tools/schemas/wallet-params.d.ts +9 -0
- package/build/tools/schemas/wallet-params.js +52 -0
- package/build/tools/schemas/wallet-params.js.map +1 -0
- package/build/tools/swap-routing.d.ts +25 -0
- package/build/tools/swap-routing.js +189 -0
- package/build/tools/swap-routing.js.map +1 -0
- package/build/tools/types.d.ts +186 -0
- package/build/tools/types.js +2 -0
- package/build/tools/types.js.map +1 -0
- package/build/tools/utils/normalize-token.d.ts +2 -0
- package/build/tools/utils/normalize-token.js +12 -0
- package/build/tools/utils/normalize-token.js.map +1 -0
- package/build/tools/utils/wallet.d.ts +4 -0
- package/build/tools/utils/wallet.js +8 -0
- package/build/tools/utils/wallet.js.map +1 -0
- package/build/tools/website-sync.d.ts +28 -0
- package/build/tools/website-sync.js +294 -0
- package/build/tools/website-sync.js.map +1 -0
- package/build/types/prepared.d.ts +43 -0
- package/build/types/prepared.js +15 -0
- package/build/types/prepared.js.map +1 -0
- package/build/utils/celo-account.d.ts +3 -0
- package/build/utils/celo-account.js +22 -0
- package/build/utils/celo-account.js.map +1 -0
- package/build/utils/celo-format.d.ts +6 -0
- package/build/utils/celo-format.js +17 -0
- package/build/utils/celo-format.js.map +1 -0
- package/build/utils/election-vote-neighbors.d.ts +12 -0
- package/build/utils/election-vote-neighbors.js +27 -0
- package/build/utils/election-vote-neighbors.js.map +1 -0
- package/build/utils/erc20-allowance-storage.d.ts +20 -0
- package/build/utils/erc20-allowance-storage.js +64 -0
- package/build/utils/erc20-allowance-storage.js.map +1 -0
- package/build/utils/fixidity.d.ts +11 -0
- package/build/utils/fixidity.js +24 -0
- package/build/utils/fixidity.js.map +1 -0
- package/build/utils/format-date.d.ts +2 -0
- package/build/utils/format-date.js +13 -0
- package/build/utils/format-date.js.map +1 -0
- package/build/utils/format-duration.d.ts +2 -0
- package/build/utils/format-duration.js +17 -0
- package/build/utils/format-duration.js.map +1 -0
- package/build/utils/format-unix-datetime.d.ts +4 -0
- package/build/utils/format-unix-datetime.js +18 -0
- package/build/utils/format-unix-datetime.js.map +1 -0
- package/build/utils/gooddollar-ubi-period.d.ts +23 -0
- package/build/utils/gooddollar-ubi-period.js +23 -0
- package/build/utils/gooddollar-ubi-period.js.map +1 -0
- package/build/utils/governance-queue.d.ts +28 -0
- package/build/utils/governance-queue.js +60 -0
- package/build/utils/governance-queue.js.map +1 -0
- package/build/utils/normalize-address.d.ts +7 -0
- package/build/utils/normalize-address.js +16 -0
- package/build/utils/normalize-address.js.map +1 -0
- package/build/utils/normalize-private-key.d.ts +17 -0
- package/build/utils/normalize-private-key.js +37 -0
- package/build/utils/normalize-private-key.js.map +1 -0
- package/build/utils/self-format.d.ts +73 -0
- package/build/utils/self-format.js +134 -0
- package/build/utils/self-format.js.map +1 -0
- package/build/utils/self-signing.d.ts +4 -0
- package/build/utils/self-signing.js +38 -0
- package/build/utils/self-signing.js.map +1 -0
- package/build/utils/stake-eligibility.d.ts +38 -0
- package/build/utils/stake-eligibility.js +55 -0
- package/build/utils/stake-eligibility.js.map +1 -0
- package/build/utils/transaction-errors.d.ts +3 -0
- package/build/utils/transaction-errors.js +17 -0
- package/build/utils/transaction-errors.js.map +1 -0
- package/package.json +129 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 CNV Labs KO XYZ
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,168 @@
|
|
|
1
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/andrewkimjoseph/celina/main/assets/celina-banner.svg" alt="Celina — Give your LLM a wallet on Celo">
|
|
3
|
+
</p>
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
# Celina SDK
|
|
6
|
+
|
|
7
|
+
> **Server-side only.** This package includes server-native dependencies (`@agentkarma/sdk`, `@celo/attribution-tags`) that cannot be bundled for the browser. Import it only from Node.js environments — API routes, background workers (BullMQ / Vercel Cron), or CLI scripts.
|
|
8
|
+
|
|
9
|
+
Celina is a third-party, open-source stack that gives an LLM read, prepare, and execute access to Celo mainnet through an SDK, an MCP server, and a REST API. This package is the SDK — a Celo mainnet library for frontend apps and agents: **reads**, **unsigned transaction preparation**, and optional **ERC-4337 AA** via `createAAClient` (app-owned gas sponsorship credentials).
|
|
10
|
+
|
|
11
|
+
Pair with [wagmi](https://wagmi.sh) / viem for EOA signing, or `createAAClient` for sponsored/batched UserOps.
|
|
12
|
+
|
|
13
|
+
Listed in the [official Celo MCP docs](https://docs.celo.org/build-on-celo/build-with-ai/mcp/celina).
|
|
14
|
+
|
|
15
|
+
## Stack
|
|
16
|
+
|
|
17
|
+
Celina is layered from chain logic through agent tooling:
|
|
18
|
+
|
|
19
|
+
| Layer | Package | Role |
|
|
20
|
+
|-------|---------|------|
|
|
21
|
+
| **SDK** | `@cnvlabskoxyz/celina-sdk` | Reads, gas estimates, `prepare*` flows (`chainId: 42220`), ERC-8021 attribution, `createAAClient` |
|
|
22
|
+
| **MCP** | `@cnvlabskoxyz/celina-mcp` | MCP tools for Cursor / Claude / LM Studio — stdio writes or hosted reads ([install guide](https://www.usecelina.xyz/mcp/local)) |
|
|
23
|
+
| **MCP remote** | `celina-mcp-remote` | Vercel Streamable HTTP + A2A — **50 hosted read tools**; no server-key writes; no sponsorship keys |
|
|
24
|
+
|
|
25
|
+
This repo is the **SDK**. Downstream packages depend on published npm semver (no local `file:` links in production).
|
|
26
|
+
|
|
27
|
+
## Install
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm i @cnvlabskoxyz/celina-sdk
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Requires Node.js ≥ 20.
|
|
34
|
+
|
|
35
|
+
## Package exports
|
|
36
|
+
|
|
37
|
+
| Export | Purpose |
|
|
38
|
+
|--------|---------|
|
|
39
|
+
| `@cnvlabskoxyz/celina-sdk` | `createCelinaClient`, domain services, `parsePrivateKeyEnv` |
|
|
40
|
+
| `@cnvlabskoxyz/celina-sdk/tools` | Shared LLM tool catalog (`ToolDefinition`, `filterToolDefinitions`) |
|
|
41
|
+
| `@cnvlabskoxyz/celina-sdk/simulation` | `simulatePreparedStep` — dry-run prepared txs before broadcast |
|
|
42
|
+
| `@cnvlabskoxyz/celina-sdk/a2a` | A2A agent card handler (used by celina-mcp-remote) |
|
|
43
|
+
| `@cnvlabskoxyz/celina-sdk/oasf` | OASF manifest helpers for agent discovery |
|
|
44
|
+
| `@cnvlabskoxyz/celina-sdk/testing` | Test harness entry for fork/integration tests |
|
|
45
|
+
|
|
46
|
+
### LLM tool catalog (v0.5+)
|
|
47
|
+
|
|
48
|
+
For MCP servers and chat APIs (Vercel AI SDK, etc.), import shared tool definitions from `@cnvlabskoxyz/celina-sdk/tools` instead of redefining schemas. See [LLM tool catalog](docs/guides/tool-catalog.md) — includes the recommended **`dynamicTool`** pattern so TypeScript does not OOM on large tool sets.
|
|
49
|
+
|
|
50
|
+
### Sign-time simulation (v0.9.6+)
|
|
51
|
+
|
|
52
|
+
Before broadcasting prepared steps, call `simulatePreparedStep` from `@cnvlabskoxyz/celina-sdk/simulation` — browser-safe, no Node analytics. See [Prepared-step simulation](docs/guides/prepared-step-simulation.md).
|
|
53
|
+
|
|
54
|
+
## Documentation
|
|
55
|
+
|
|
56
|
+
**Full docs:** [celina-sdk on GitBook](https://andrewkimjoseph.gitbook.io/celina-sdk)
|
|
57
|
+
|
|
58
|
+
- [Quick start](https://andrewkimjoseph.gitbook.io/celina-sdk/getting-started/quick-start)
|
|
59
|
+
- [LLM tool catalog](docs/guides/tool-catalog.md) — `@cnvlabskoxyz/celina-sdk/tools` for MCP and AI SDK hosts
|
|
60
|
+
- [Architecture](docs/concepts/architecture.md) — client composition and stack
|
|
61
|
+
- [Prepared flows](docs/concepts/prepared-flows.md) — `SerializedPreparedFlow` (`chainId: 42220`), ERC-8021 Celina attribution
|
|
62
|
+
- [On-chain attribution](docs/guides/on-chain-attribution.md) — wire format, check vs verify, Celina vs AA tags
|
|
63
|
+
- [Account Abstraction](docs/guides/account-abstraction.md) — `createAAClient`, app-owned sponsorship, AA `attributionTags`
|
|
64
|
+
- [Prepared-step simulation](docs/guides/prepared-step-simulation.md) — `simulatePreparedStep` before wallet send
|
|
65
|
+
- [wagmi integration](https://andrewkimjoseph.gitbook.io/celina-sdk/guides/wagmi-integration)
|
|
66
|
+
- [GoodDollar](docs/guides/gooddollar.md) — UBI whitelist/claim and G$ ↔ USDm reserve swaps
|
|
67
|
+
- [Governance](docs/guides/governance.md) — lock CELO, vote, upvote, withdraw (humanness-gated)
|
|
68
|
+
- [Staking](docs/guides/staking.md) — validator election stake, Celo Mondo delegate directory, delegate/undelegate (humanness-gated)
|
|
69
|
+
- [Humanness](docs/guides/humanness.md) — dual-rail Self + GoodDollar gate for governance/staking writes
|
|
70
|
+
- [Self Agent ID](docs/guides/self-agent-id.md) — verify, register, refresh human-backed agents
|
|
71
|
+
- [AgentKarma reputation](docs/guides/agentkarma.md) — karma reads and counterparty trust policy
|
|
72
|
+
- [Telemetry](docs/guides/telemetry.md) — read metrics always reported to celina-stats-api (`device_id` per project — set `analyticsDeviceId` explicitly; `user_id` per wallet). On serverless hosts keep the isolate alive with `drainCelinaAnalytics()` via `waitUntil` / `after`. Anyone who does not want telemetry can fork the repository.
|
|
73
|
+
- [API reference](https://andrewkimjoseph.gitbook.io/celina-sdk/api-reference)
|
|
74
|
+
|
|
75
|
+
Docs source lives in [`docs/`](docs/) in this repository.
|
|
76
|
+
|
|
77
|
+
## Quick example
|
|
78
|
+
|
|
79
|
+
```ts
|
|
80
|
+
import { createCelinaClient } from "@cnvlabskoxyz/celina-sdk";
|
|
81
|
+
|
|
82
|
+
const celina = createCelinaClient({
|
|
83
|
+
attributionTags: ["celo_862c21dd97a7", "my_app"],
|
|
84
|
+
// ERC-8021 → codes celina, celo_862c21dd97a7, my_app
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
await celina.token.getStablecoinBalances("0xYourAddress");
|
|
88
|
+
|
|
89
|
+
const flow = await celina.transaction.prepareSend("0xFrom", "0xTo", "USDm", "10");
|
|
90
|
+
// flow.steps → simulate each step, then wagmi sendTransactionAsync (see /simulation)
|
|
91
|
+
|
|
92
|
+
// GoodDollar UBI (reads + unsigned claim)
|
|
93
|
+
const eligibility = await celina.gooddollar.getUbiClaimEligibility("0xYourAddress");
|
|
94
|
+
const ubiFlow = await celina.gooddollar.prepareClaimUbi("0xYourAddress");
|
|
95
|
+
|
|
96
|
+
// GoodDollar reserve (G$ ↔ USDm — bonding curve, not Uniswap)
|
|
97
|
+
const reserveQuote = await celina.gooddollar.getReserveQuote("GoodDollar", "USDm", "1000");
|
|
98
|
+
// reserveQuote.protocol === "gooddollar_reserve"
|
|
99
|
+
const reserveFlow = await celina.gooddollar.prepareReserveSwap(
|
|
100
|
+
"0xFrom",
|
|
101
|
+
"GoodDollar",
|
|
102
|
+
"USDm",
|
|
103
|
+
"1000",
|
|
104
|
+
);
|
|
105
|
+
|
|
106
|
+
// Governance & staking (humanness-gated prepare* for browser signing)
|
|
107
|
+
const human = await celina.humanness.checkHumanness("0xYourAddress");
|
|
108
|
+
const proposals = await celina.governance.getProposals({ stage: "Queued" });
|
|
109
|
+
const groups = await celina.staking.getValidatorGroups();
|
|
110
|
+
const delegates = await celina.staking.getGovernanceDelegates({ search: "governance", limit: 5 });
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## Prepared flows and calldata tagging
|
|
114
|
+
|
|
115
|
+
All `prepare*` methods return a **`SerializedPreparedFlow`**: ordered unsigned steps for the user's wallet.
|
|
116
|
+
|
|
117
|
+
Every step with calldata gets an **ERC-8021 Schema 0** attribution suffix via `appendCelinaCalldataTag` — sends, Mento FX, Uniswap, Aave, and GoodDollar. Pass `step.data` to wagmi unchanged.
|
|
118
|
+
|
|
119
|
+
Optional `attributionTags` in `createCelinaClient({ attributionTags: [...] })` set custom codes after platform `celina` (deduped, stable order). The same option on **`createAAClient`** tags at `sendPreparedFlow` time (omit for pass-through). Prepared flows expose **`chainId: 42220`**. List or check on-chain tags with `check_attribution_tag` (preferred) or `checkAttributionInCalldata`; use `verify_attribution_tag` / `verifyAttributionInCalldata` for raw layers (including historical legacy `CELINA|…` when present).
|
|
120
|
+
|
|
121
|
+
Before opening the wallet, simulate each step against current chain state with `@cnvlabskoxyz/celina-sdk/simulation` (`simulatePreparedStep`). Local **celina-mcp** stdio writes use the same helper in `executePreparedFlow` before broadcast.
|
|
122
|
+
|
|
123
|
+
For **sponsored / batched UserOps**, use [`createAAClient`](docs/guides/account-abstraction.md) from `@cnvlabskoxyz/celina-sdk/aa` with an app-owned gas sponsorship provider (v1: Pimlico). MCP does not host sponsorship API keys.
|
|
124
|
+
|
|
125
|
+
See [Prepared flows](docs/concepts/prepared-flows.md), [On-chain attribution](docs/guides/on-chain-attribution.md), [Prepared-step simulation](docs/guides/prepared-step-simulation.md), and [Account Abstraction](docs/guides/account-abstraction.md).
|
|
126
|
+
|
|
127
|
+
### MCP session wallet (not in the SDK)
|
|
128
|
+
|
|
129
|
+
Local **celina-mcp** stdio can configure **`CELO_PRIVATE_KEY`**, **`SELF_AGENT_PRIVATE_KEY`**, or **both**. With a key set, omit wallet params on many MCP tools and use **`get_wallet_address`** instead of shelling out for the signer. Pass optional `signer: "celo" | "self_agent"` on execute tools when both keys are configured. **Self-only** setups (no `CELO_PRIVATE_KEY`) are valid for governance/staking when the Self agent passes humanness — do not leave placeholder CELO keys in config.
|
|
130
|
+
|
|
131
|
+
The SDK always requires an explicit `0x…` from your app (e.g. wagmi). See [MCP session wallet](docs/guides/mcp-session-wallet.md). **Celeste AI** is an independent app built on this SDK + browser wallet signing — it does not use celina-mcp.
|
|
132
|
+
|
|
133
|
+
## GoodDollar
|
|
134
|
+
|
|
135
|
+
Identity whitelist reads, daily UBI entitlement, unsigned UBI claim, and **G$ ↔ USDm reserve swaps** via the on-chain MentoBroker bonding curve.
|
|
136
|
+
|
|
137
|
+
| Reads | Prepare |
|
|
138
|
+
|-------|---------|
|
|
139
|
+
| `getWhitelistingInfo`, `getUbiClaimEligibility`, `getReserveQuote` | `prepareClaimUbi`, `prepareReserveSwap` |
|
|
140
|
+
|
|
141
|
+
For **G$ ↔ USDm**, use `getReserveQuote` / `prepareReserveSwap` (or aggregated `getSwapQuoteWithFallback` from `@cnvlabskoxyz/celina-sdk/tools`) — not Uniswap. For other G$ pairs (e.g. G$ → USDT), Uniswap v3 and v4 remain the AMM fallback. The quote keeps the higher output.
|
|
142
|
+
|
|
143
|
+
MCP: `get_gooddollar_whitelisting_info`, `get_gooddollar_ubi_entitlement`, `get_gooddollar_reserve_quote`, `estimate_gooddollar_reserve_swap`, `execute_gooddollar_reserve_swap` (stdio write with server key); `claim_daily_gooddollar_ubi` (stdio UBI write). Browser apps: `prepareClaimUbi`, `prepareReserveSwap`, or `prepare_swap` + wagmi.
|
|
144
|
+
|
|
145
|
+
[GoodDollar guide](docs/guides/gooddollar.md)
|
|
146
|
+
|
|
147
|
+
## Related packages
|
|
148
|
+
|
|
149
|
+
- [`@cnvlabskoxyz/celina-mcp`](https://www.usecelina.xyz/mcp/local) — MCP server (`get_wallet_address`, optional address on wallet-scoped tools); [install guide](https://www.usecelina.xyz/mcp/local)
|
|
150
|
+
- [`celina-mcp-remote`](../celina-mcp-remote/) — Cloudflare Worker-hosted remote MCP endpoint (`https://mcp.usecelina.xyz/mcp`)
|
|
151
|
+
- [`@selfxyz/agent-sdk`](https://www.npmjs.com/package/@selfxyz/agent-sdk) — Self Agent ID browser flows
|
|
152
|
+
|
|
153
|
+
## Roadmap
|
|
154
|
+
|
|
155
|
+
- [x] Mento FX routing (`getFxQuote`, `estimateFx`, `prepareFx`)
|
|
156
|
+
- [x] Uniswap v3 and v4 swaps (`getSwapQuote`, `estimateSwap`, `prepareSwap`)
|
|
157
|
+
- [x] GoodDollar reserve swaps (`getReserveQuote`, `prepareReserveSwap`) — G$ ↔ USDm via MentoBroker
|
|
158
|
+
- [x] Aave tools (`getBalances` / MCP `get_aave_balances`, `prepareSupply`, `prepareWithdraw`) — USDT, WETH, USDm, USDC, CELO, EURm
|
|
159
|
+
- [x] Self proof verification (`verifySelfAgent`, `verifySelfRequest`, ai.self.xyz)
|
|
160
|
+
- [x] Self Agent ID (`lookupSelfAgent`, registration & lifecycle tools)
|
|
161
|
+
- [x] Governance (`prepareLockCelo`, `prepareVote`, `prepareUpvote`, revoke prepares — humanness-gated)
|
|
162
|
+
- [x] Staking (`prepareStake`, `prepareActivateStake`, delegate/undelegate prepares — humanness-gated)
|
|
163
|
+
- [x] Humanness dual-rail gate (`checkHumanness` — Self Agent ID or GoodDollar whitelist)
|
|
164
|
+
- [x] GoodDollar identity link, face verification, connect/disconnect wallet tools
|
|
165
|
+
|
|
166
|
+
## License
|
|
167
|
+
|
|
168
|
+
MIT — Copyright (c) 2026 CNV Labs KO XYZ.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { type CelinaA2ASkill } from "./skills.js";
|
|
2
|
+
export interface CelinaAgentCardOptions {
|
|
3
|
+
/** Public remote MCP base URL for JSON-RPC execution, e.g. https://mcp.usecelina.xyz */
|
|
4
|
+
mcpBaseUrl?: string;
|
|
5
|
+
/** @deprecated Use mcpBaseUrl. Kept for backward compatibility. */
|
|
6
|
+
baseUrl?: string;
|
|
7
|
+
/** Celina package version shown on the card */
|
|
8
|
+
version: string;
|
|
9
|
+
}
|
|
10
|
+
export interface CelinaA2AAgentCard {
|
|
11
|
+
name: string;
|
|
12
|
+
description: string;
|
|
13
|
+
protocolVersion: string;
|
|
14
|
+
version: string;
|
|
15
|
+
url: string;
|
|
16
|
+
skills: Array<{
|
|
17
|
+
id: string;
|
|
18
|
+
name: string;
|
|
19
|
+
description: string;
|
|
20
|
+
tags: string[];
|
|
21
|
+
examples: string[];
|
|
22
|
+
}>;
|
|
23
|
+
capabilities: {
|
|
24
|
+
streaming: boolean;
|
|
25
|
+
pushNotifications: boolean;
|
|
26
|
+
};
|
|
27
|
+
defaultInputModes: string[];
|
|
28
|
+
defaultOutputModes: string[];
|
|
29
|
+
additionalInterfaces: Array<{
|
|
30
|
+
url: string;
|
|
31
|
+
transport: string;
|
|
32
|
+
}>;
|
|
33
|
+
/** Celina-specific task payload mime type */
|
|
34
|
+
extensions?: Record<string, unknown>;
|
|
35
|
+
}
|
|
36
|
+
export declare function buildCelinaA2ASkills(): CelinaA2ASkill[];
|
|
37
|
+
export declare function buildCelinaAgentCard(options: CelinaAgentCardOptions): CelinaA2AAgentCard;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { buildSkillsFromToolNames, CELINA_TOOL_MIME, } from "./skills.js";
|
|
2
|
+
import { getHostedMcpToolNames, TOOL_CATEGORY_BY_NAME, } from "../tools/website-sync.js";
|
|
3
|
+
const DEFAULT_DESCRIPTION = "Celina is a third-party, open-source stack that gives an LLM read, prepare, and execute access to Celo mainnet through an SDK, an MCP server, and a REST API. This hosted agent exposes read-only access to balances, DeFi quotes, governance, staking, NFTs, and Self Agent ID verification via structured tool calls.";
|
|
4
|
+
export function buildCelinaA2ASkills() {
|
|
5
|
+
return buildSkillsFromToolNames(getHostedMcpToolNames(), TOOL_CATEGORY_BY_NAME);
|
|
6
|
+
}
|
|
7
|
+
export function buildCelinaAgentCard(options) {
|
|
8
|
+
const mcpBase = (options.mcpBaseUrl ??
|
|
9
|
+
options.baseUrl ??
|
|
10
|
+
"https://mcp.usecelina.xyz").replace(/\/$/, "");
|
|
11
|
+
const jsonRpcUrl = `${mcpBase}/a2a`;
|
|
12
|
+
const skills = buildCelinaA2ASkills();
|
|
13
|
+
return {
|
|
14
|
+
name: "Celina",
|
|
15
|
+
description: DEFAULT_DESCRIPTION,
|
|
16
|
+
protocolVersion: "0.3.0",
|
|
17
|
+
version: options.version,
|
|
18
|
+
url: jsonRpcUrl,
|
|
19
|
+
skills: skills.map((skill) => ({
|
|
20
|
+
id: skill.id,
|
|
21
|
+
name: skill.name,
|
|
22
|
+
description: skill.description,
|
|
23
|
+
tags: skill.tags,
|
|
24
|
+
examples: skill.examples,
|
|
25
|
+
})),
|
|
26
|
+
capabilities: {
|
|
27
|
+
streaming: false,
|
|
28
|
+
pushNotifications: false,
|
|
29
|
+
},
|
|
30
|
+
defaultInputModes: ["text", "data"],
|
|
31
|
+
defaultOutputModes: ["text", "data"],
|
|
32
|
+
additionalInterfaces: [
|
|
33
|
+
{ url: jsonRpcUrl, transport: "JSONRPC" },
|
|
34
|
+
],
|
|
35
|
+
extensions: {
|
|
36
|
+
celina: {
|
|
37
|
+
toolPayloadMime: CELINA_TOOL_MIME,
|
|
38
|
+
toolPayloadSchema: {
|
|
39
|
+
tool: "string — hosted MCP tool name",
|
|
40
|
+
arguments: "object — snake_case tool arguments",
|
|
41
|
+
},
|
|
42
|
+
},
|
|
43
|
+
},
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=agent-card.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAsClC,MAAM,mBAAmB,GACvB,yTAAyT,CAAC;AAE5T,MAAM,UAAU,oBAAoB;IAClC,OAAO,wBAAwB,CAAC,qBAAqB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,MAAM,OAAO,GAAG,CACd,OAAO,CAAC,UAAU;QAClB,OAAO,CAAC,OAAO;QACf,2BAA2B,CAC5B,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrB,MAAM,UAAU,GAAG,GAAG,OAAO,MAAM,CAAC;IACpC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,YAAY,EAAE;YACZ,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,KAAK;SACzB;QACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACpC,oBAAoB,EAAE;YACpB,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE;SAC1C;QACD,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,eAAe,EAAE,gBAAgB;gBACjC,iBAAiB,EAAE;oBACjB,IAAI,EAAE,+BAA+B;oBACrC,SAAS,EAAE,oCAAoC;iBAChD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
export { buildCelinaAgentCard, buildCelinaA2ASkills, type CelinaAgentCardOptions, type CelinaA2AAgentCard, } from "./agent-card.js";
|
|
2
|
+
export { buildSkillsFromToolNames, CATEGORY_TO_A2A_SKILL, CELINA_TOOL_MIME, type CelinaA2ASkill, type CelinaA2ASkillMeta, } from "./skills.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GAGjB,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { WebsiteToolCategory } from "../tools/website-sync.js";
|
|
2
|
+
export declare const CELINA_TOOL_MIME = "application/vnd.celina.tool+json";
|
|
3
|
+
export interface CelinaA2ASkillMeta {
|
|
4
|
+
id: string;
|
|
5
|
+
name: string;
|
|
6
|
+
tags: string[];
|
|
7
|
+
}
|
|
8
|
+
/** Maps website tool categories to A2A skill metadata (hosted read profile). */
|
|
9
|
+
export declare const CATEGORY_TO_A2A_SKILL: Record<WebsiteToolCategory, CelinaA2ASkillMeta>;
|
|
10
|
+
export interface CelinaA2ASkill {
|
|
11
|
+
id: string;
|
|
12
|
+
name: string;
|
|
13
|
+
description: string;
|
|
14
|
+
tags: string[];
|
|
15
|
+
tools: string[];
|
|
16
|
+
examples: string[];
|
|
17
|
+
}
|
|
18
|
+
export declare function buildSkillsFromToolNames(toolNames: string[], categoryByName: Record<string, WebsiteToolCategory>): CelinaA2ASkill[];
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
export const CELINA_TOOL_MIME = "application/vnd.celina.tool+json";
|
|
2
|
+
/** Maps website tool categories to A2A skill metadata (hosted read profile). */
|
|
3
|
+
export const CATEGORY_TO_A2A_SKILL = {
|
|
4
|
+
Blockchain: {
|
|
5
|
+
id: "celo-blockchain",
|
|
6
|
+
name: "Celo blockchain reads",
|
|
7
|
+
tags: ["celo", "blockchain", "mainnet"],
|
|
8
|
+
},
|
|
9
|
+
Account: {
|
|
10
|
+
id: "celo-balances",
|
|
11
|
+
name: "Celo balances",
|
|
12
|
+
tags: ["celo", "balances", "account"],
|
|
13
|
+
},
|
|
14
|
+
Token: {
|
|
15
|
+
id: "celo-balances",
|
|
16
|
+
name: "Celo balances",
|
|
17
|
+
tags: ["celo", "balances", "token"],
|
|
18
|
+
},
|
|
19
|
+
Transaction: {
|
|
20
|
+
id: "celo-transaction",
|
|
21
|
+
name: "Celo transaction reads",
|
|
22
|
+
tags: ["celo", "transaction"],
|
|
23
|
+
},
|
|
24
|
+
"Mento FX": {
|
|
25
|
+
id: "mento-fx",
|
|
26
|
+
name: "Mento FX quotes",
|
|
27
|
+
tags: ["celo", "mento", "fx", "swap"],
|
|
28
|
+
},
|
|
29
|
+
Uniswap: {
|
|
30
|
+
id: "uniswap",
|
|
31
|
+
name: "Uniswap v3 and v4 quotes",
|
|
32
|
+
tags: ["celo", "uniswap", "swap", "amm"],
|
|
33
|
+
},
|
|
34
|
+
Wallet: {
|
|
35
|
+
id: "ens",
|
|
36
|
+
name: "ENS resolution",
|
|
37
|
+
tags: ["celo", "ens", "wallet"],
|
|
38
|
+
},
|
|
39
|
+
GoodDollar: {
|
|
40
|
+
id: "gooddollar",
|
|
41
|
+
name: "GoodDollar reads",
|
|
42
|
+
tags: ["celo", "gooddollar", "ubi", "reserve"],
|
|
43
|
+
},
|
|
44
|
+
Aave: {
|
|
45
|
+
id: "aave",
|
|
46
|
+
name: "Aave V3 reads",
|
|
47
|
+
tags: ["celo", "aave", "defi"],
|
|
48
|
+
},
|
|
49
|
+
Self: {
|
|
50
|
+
id: "self-verify",
|
|
51
|
+
name: "Self Agent ID verification",
|
|
52
|
+
tags: ["celo", "self", "identity", "agent"],
|
|
53
|
+
},
|
|
54
|
+
Governance: {
|
|
55
|
+
id: "governance",
|
|
56
|
+
name: "Celo governance",
|
|
57
|
+
tags: ["celo", "governance", "cgp"],
|
|
58
|
+
},
|
|
59
|
+
Staking: {
|
|
60
|
+
id: "staking",
|
|
61
|
+
name: "Celo staking",
|
|
62
|
+
tags: ["celo", "staking", "validators"],
|
|
63
|
+
},
|
|
64
|
+
Humanness: {
|
|
65
|
+
id: "humanness",
|
|
66
|
+
name: "Humanness verification",
|
|
67
|
+
tags: ["celo", "humanness", "self", "gooddollar", "identity"],
|
|
68
|
+
},
|
|
69
|
+
NFT: {
|
|
70
|
+
id: "nft",
|
|
71
|
+
name: "NFT reads",
|
|
72
|
+
tags: ["celo", "nft", "erc721", "erc1155"],
|
|
73
|
+
},
|
|
74
|
+
Contract: {
|
|
75
|
+
id: "contract-read",
|
|
76
|
+
name: "Contract reads",
|
|
77
|
+
tags: ["celo", "contract", "abi"],
|
|
78
|
+
},
|
|
79
|
+
AgentKarma: {
|
|
80
|
+
id: "agentkarma-reputation",
|
|
81
|
+
name: "AgentKarma reputation reads",
|
|
82
|
+
tags: ["celo", "agentkarma", "reputation", "trust", "erc-8004"],
|
|
83
|
+
},
|
|
84
|
+
};
|
|
85
|
+
export function buildSkillsFromToolNames(toolNames, categoryByName) {
|
|
86
|
+
const bySkillId = new Map();
|
|
87
|
+
for (const toolName of toolNames) {
|
|
88
|
+
const category = categoryByName[toolName] ?? "Blockchain";
|
|
89
|
+
const meta = CATEGORY_TO_A2A_SKILL[category];
|
|
90
|
+
const existing = bySkillId.get(meta.id);
|
|
91
|
+
if (existing) {
|
|
92
|
+
existing.tools.push(toolName);
|
|
93
|
+
continue;
|
|
94
|
+
}
|
|
95
|
+
bySkillId.set(meta.id, {
|
|
96
|
+
id: meta.id,
|
|
97
|
+
name: meta.name,
|
|
98
|
+
description: `${meta.name} on Celo mainnet. Tools: ${toolName}.`,
|
|
99
|
+
tags: [...meta.tags],
|
|
100
|
+
tools: [toolName],
|
|
101
|
+
examples: [
|
|
102
|
+
`Send a DataPart (${CELINA_TOOL_MIME}) with {"tool":"${toolName}","arguments":{...}}.`,
|
|
103
|
+
],
|
|
104
|
+
});
|
|
105
|
+
}
|
|
106
|
+
for (const skill of bySkillId.values()) {
|
|
107
|
+
skill.description = `${skill.name} on Celo mainnet. Allowed tools: ${skill.tools.join(", ")}.`;
|
|
108
|
+
}
|
|
109
|
+
return [...bySkillId.values()].sort((a, b) => a.id.localeCompare(b.id));
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=skills.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/a2a/skills.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { type Hex, type PrivateKeyAccount, type PublicClient } from "viem";
|
|
2
|
+
import type { PreparedFlow, SerializedPreparedFlow } from "../types/prepared.js";
|
|
3
|
+
import { GasSponsorshipService } from "./gas-sponsorship.js";
|
|
4
|
+
import type { CreateAAClientOptions, GasSponsorshipProviderId, SendPreparedFlowOptions, SendPreparedFlowResult } from "./types.js";
|
|
5
|
+
/**
|
|
6
|
+
* Derive the counterfactual Simple Smart Account address for an EOA owner
|
|
7
|
+
* (EntryPoint 0.7) without submitting a UserOp.
|
|
8
|
+
*/
|
|
9
|
+
export declare function deriveSmartAccountAddress(owner: PrivateKeyAccount | Hex, publicClient?: PublicClient): Promise<{
|
|
10
|
+
eoaAddress: `0x${string}`;
|
|
11
|
+
smartAccountAddress: `0x${string}`;
|
|
12
|
+
}>;
|
|
13
|
+
export type AAClient = {
|
|
14
|
+
/** Gas sponsorship backend id (e.g. `"pimlico"`). */
|
|
15
|
+
provider: GasSponsorshipProviderId;
|
|
16
|
+
/** EOA that owns the smart account. */
|
|
17
|
+
eoaAddress: `0x${string}`;
|
|
18
|
+
/** Counterfactual / deployed Simple Smart Account address. */
|
|
19
|
+
smartAccountAddress: `0x${string}`;
|
|
20
|
+
/** Underlying sponsorship service (URLs, paymaster, fees). */
|
|
21
|
+
gasSponsorship: GasSponsorshipService;
|
|
22
|
+
/**
|
|
23
|
+
* Tags applied in `sendPreparedFlow` via `appendCelinaCalldataTag`.
|
|
24
|
+
* `undefined` means step `data` is passed through unchanged.
|
|
25
|
+
*/
|
|
26
|
+
attributionTags: string[] | undefined;
|
|
27
|
+
/**
|
|
28
|
+
* Submit `prepare*` output (ordered `steps` / prepared transactions) as sponsored UserOp(s).
|
|
29
|
+
* When `attributionTags` were set on this client, each step’s `data` is ERC-8021-tagged
|
|
30
|
+
* before submit; otherwise `data` is used as-is (including tags from `prepare*`).
|
|
31
|
+
*/
|
|
32
|
+
sendPreparedFlow: (flow: PreparedFlow | SerializedPreparedFlow, options?: SendPreparedFlowOptions) => Promise<SendPreparedFlowResult>;
|
|
33
|
+
};
|
|
34
|
+
/**
|
|
35
|
+
* Create an ERC-4337 AA client on Celo mainnet (Simple Smart Account, EntryPoint 0.7).
|
|
36
|
+
*
|
|
37
|
+
* Pass an explicit `gasSponsorship` provider object — credentials are app-owned
|
|
38
|
+
* and never stored by Celina. v1 supports `provider: "pimlico"`.
|
|
39
|
+
*
|
|
40
|
+
* Optional `attributionTags` are applied in `sendPreparedFlow` via
|
|
41
|
+
* `appendCelinaCalldataTag` (same ERC-8021 format as `prepare*`). Omit them to
|
|
42
|
+
* pass step calldata through unchanged.
|
|
43
|
+
*/
|
|
44
|
+
export declare function createAAClient(options: CreateAAClientOptions): Promise<AAClient>;
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import { createPublicClient, http, } from "viem";
|
|
2
|
+
import { entryPoint07Address } from "viem/account-abstraction";
|
|
3
|
+
import { privateKeyToAccount } from "viem/accounts";
|
|
4
|
+
import { createSmartAccountClient } from "permissionless";
|
|
5
|
+
import { toSimpleSmartAccount } from "permissionless/accounts";
|
|
6
|
+
import { CHAIN, DEFAULT_RPC_URL } from "../config/chains.js";
|
|
7
|
+
import { GasSponsorshipService } from "./gas-sponsorship.js";
|
|
8
|
+
import { preparedStepsToUserOpCalls } from "./prepared-calls.js";
|
|
9
|
+
import { reportCelinaOnchainTxn } from "../analytics/onchain-stats.js";
|
|
10
|
+
function resolveOwner(owner) {
|
|
11
|
+
if (typeof owner === "string") {
|
|
12
|
+
return privateKeyToAccount(owner);
|
|
13
|
+
}
|
|
14
|
+
return owner;
|
|
15
|
+
}
|
|
16
|
+
function defaultPublicClient() {
|
|
17
|
+
return createPublicClient({
|
|
18
|
+
chain: CHAIN,
|
|
19
|
+
transport: http(DEFAULT_RPC_URL),
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Derive the counterfactual Simple Smart Account address for an EOA owner
|
|
24
|
+
* (EntryPoint 0.7) without submitting a UserOp.
|
|
25
|
+
*/
|
|
26
|
+
export async function deriveSmartAccountAddress(owner, publicClient) {
|
|
27
|
+
const eoaAccount = resolveOwner(owner);
|
|
28
|
+
const client = publicClient ?? defaultPublicClient();
|
|
29
|
+
const smartAccount = await toSimpleSmartAccount({
|
|
30
|
+
client,
|
|
31
|
+
owner: eoaAccount,
|
|
32
|
+
entryPoint: {
|
|
33
|
+
address: entryPoint07Address,
|
|
34
|
+
version: "0.7",
|
|
35
|
+
},
|
|
36
|
+
});
|
|
37
|
+
return {
|
|
38
|
+
eoaAddress: eoaAccount.address,
|
|
39
|
+
smartAccountAddress: smartAccount.address,
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Create an ERC-4337 AA client on Celo mainnet (Simple Smart Account, EntryPoint 0.7).
|
|
44
|
+
*
|
|
45
|
+
* Pass an explicit `gasSponsorship` provider object — credentials are app-owned
|
|
46
|
+
* and never stored by Celina. v1 supports `provider: "pimlico"`.
|
|
47
|
+
*
|
|
48
|
+
* Optional `attributionTags` are applied in `sendPreparedFlow` via
|
|
49
|
+
* `appendCelinaCalldataTag` (same ERC-8021 format as `prepare*`). Omit them to
|
|
50
|
+
* pass step calldata through unchanged.
|
|
51
|
+
*/
|
|
52
|
+
export async function createAAClient(options) {
|
|
53
|
+
const eoaAccount = resolveOwner(options.owner);
|
|
54
|
+
const publicClient = options.publicClient ?? defaultPublicClient();
|
|
55
|
+
const attributionTags = options.attributionTags;
|
|
56
|
+
const gasSponsorship = new GasSponsorshipService(options.gasSponsorship, CHAIN.id);
|
|
57
|
+
const smartAccount = await toSimpleSmartAccount({
|
|
58
|
+
client: publicClient,
|
|
59
|
+
owner: eoaAccount,
|
|
60
|
+
entryPoint: {
|
|
61
|
+
address: entryPoint07Address,
|
|
62
|
+
version: "0.7",
|
|
63
|
+
},
|
|
64
|
+
});
|
|
65
|
+
const paymaster = gasSponsorship.getPaymasterClient();
|
|
66
|
+
const smartAccountClient = createSmartAccountClient({
|
|
67
|
+
account: smartAccount,
|
|
68
|
+
chain: CHAIN,
|
|
69
|
+
bundlerTransport: gasSponsorship.createBundlerTransport(),
|
|
70
|
+
paymaster,
|
|
71
|
+
userOperation: {
|
|
72
|
+
estimateFeesPerGas: async () => gasSponsorship.estimateFeesPerGas(),
|
|
73
|
+
},
|
|
74
|
+
});
|
|
75
|
+
async function sendPreparedFlow(flow, sendOptions) {
|
|
76
|
+
const mode = sendOptions?.mode ?? "batch";
|
|
77
|
+
const calls = preparedStepsToUserOpCalls(flow.steps, attributionTags);
|
|
78
|
+
const userOpHashes = [];
|
|
79
|
+
const transactionHashes = [];
|
|
80
|
+
if (mode === "batch") {
|
|
81
|
+
const userOpHash = await smartAccountClient.sendUserOperation({ calls });
|
|
82
|
+
userOpHashes.push(userOpHash);
|
|
83
|
+
const receipt = await smartAccountClient.waitForUserOperationReceipt({
|
|
84
|
+
hash: userOpHash,
|
|
85
|
+
});
|
|
86
|
+
if (!receipt.success) {
|
|
87
|
+
return { mode, userOpHashes, transactionHashes, success: false };
|
|
88
|
+
}
|
|
89
|
+
transactionHashes.push(receipt.receipt.transactionHash);
|
|
90
|
+
reportCelinaOnchainTxn(receipt.receipt.transactionHash);
|
|
91
|
+
return { mode, userOpHashes, transactionHashes, success: true };
|
|
92
|
+
}
|
|
93
|
+
for (const call of calls) {
|
|
94
|
+
const userOpHash = await smartAccountClient.sendUserOperation({
|
|
95
|
+
calls: [call],
|
|
96
|
+
});
|
|
97
|
+
userOpHashes.push(userOpHash);
|
|
98
|
+
const receipt = await smartAccountClient.waitForUserOperationReceipt({
|
|
99
|
+
hash: userOpHash,
|
|
100
|
+
});
|
|
101
|
+
if (!receipt.success) {
|
|
102
|
+
return { mode, userOpHashes, transactionHashes, success: false };
|
|
103
|
+
}
|
|
104
|
+
transactionHashes.push(receipt.receipt.transactionHash);
|
|
105
|
+
reportCelinaOnchainTxn(receipt.receipt.transactionHash);
|
|
106
|
+
}
|
|
107
|
+
return { mode, userOpHashes, transactionHashes, success: true };
|
|
108
|
+
}
|
|
109
|
+
return {
|
|
110
|
+
provider: gasSponsorship.provider,
|
|
111
|
+
eoaAddress: eoaAccount.address,
|
|
112
|
+
smartAccountAddress: smartAccount.address,
|
|
113
|
+
gasSponsorship,
|
|
114
|
+
attributionTags,
|
|
115
|
+
sendPreparedFlow,
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=create-aa-client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-aa-client.js","sourceRoot":"","sources":["../../src/aa/create-aa-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { type Transport } from "viem";
|
|
2
|
+
import { createPimlicoClient } from "permissionless/clients/pimlico";
|
|
3
|
+
import type { GasSponsorshipConfig, GasSponsorshipProviderId } from "./types.js";
|
|
4
|
+
type PimlicoClient = ReturnType<typeof createPimlicoClient>;
|
|
5
|
+
/**
|
|
6
|
+
* Provider-agnostic gas sponsorship wiring (bundler URL, paymaster, fees).
|
|
7
|
+
* v1 supports `provider: "pimlico"`; add branches for future providers without renaming this type.
|
|
8
|
+
*/
|
|
9
|
+
export declare class GasSponsorshipService {
|
|
10
|
+
readonly provider: GasSponsorshipProviderId;
|
|
11
|
+
private readonly config;
|
|
12
|
+
private readonly chainId;
|
|
13
|
+
private pimlicoClient;
|
|
14
|
+
constructor(config: GasSponsorshipConfig, chainId?: number);
|
|
15
|
+
/** Bundler / paymaster JSON-RPC URL for the configured provider and chain. */
|
|
16
|
+
getRpcUrl(chainId?: number): string;
|
|
17
|
+
/** viem transport pointed at the sponsorship backend RPC. */
|
|
18
|
+
createBundlerTransport(): Transport;
|
|
19
|
+
/** Provider client used as paymaster (and fee oracle in v1). */
|
|
20
|
+
getPaymasterClient(): PimlicoClient;
|
|
21
|
+
/** Fee fields for UserOp construction. */
|
|
22
|
+
estimateFeesPerGas(): Promise<{
|
|
23
|
+
maxFeePerGas: bigint;
|
|
24
|
+
maxPriorityFeePerGas: bigint;
|
|
25
|
+
}>;
|
|
26
|
+
}
|
|
27
|
+
export {};
|