Skip to content

feat(wallet-mcp): add Tereno plugin - #27

Open
RobMartello wants to merge 1 commit into
coinbase:mainfrom
RobMartello:feat/wallet-mcp-tereno-plugin
Open

RobMartello wants to merge 1 commit into
coinbase:mainfrom
RobMartello:feat/wallet-mcp-tereno-plugin

Conversation

@RobMartello

Copy link
Copy Markdown

Description

Adds skills/wallet-mcp/plugins/tereno.md (integration: http-api, chains: [base]): pre-action onchain verification and shared-cache lookups on Base that an agent can run before a Wallet MCP swap or send_calls:

  • token.launch.guard — simulated buy/sell exit via eth_call, DEX liquidity reserve depth, LP lock/burn status, and owner privileges.
  • token.holders.guard — top-10 holder concentration, ETH funding-origin graph, and deployer-funded holder clusters.
  • contract.guard — runtime bytecode presence, EIP-1967 proxy implementation slots, pause state, and static selector flags.
  • token.metadata — ERC-20 name, symbol, decimals, and block-fresh totalSupply.
  • chain.snapshot — latest Base block, timestamp, base fee, and suggested gas parameters.
  • Free quote (GET /api/v1/capabilities/price) and content-addressed artifact verification (GET /api/v1/evidence/{artifactId}).

The plugin is strictly read-only: it never constructs or returns transaction calldata. Paid checks settle in Base USDC (eip155:8453, x402 v2) through Wallet MCP's initiate_x402_request → approval flow → complete_x402_request.

Scope — adds only skills/wallet-mcp/plugins/tereno.md and reuses existing tag vocabulary (ai-agents, agent-commerce, token-launches, trading, dex). SKILL.md and the maintainer-managed conformance/examples tables are untouched per references/plugin-spec.md#contribution-scope.

Change type

  • Harness integration or metadata
  • Skill workflow
  • Bug fix
  • Documentation
  • Breaking change (describe migration)

Validation

  • Validated frontmatter, canonical section headings, and section order against skills/wallet-mcp/references/plugin-spec.md.

  • Verified live endpoints (GET https://www.tereno.xyz/api/v1/capabilities/price, 402 x402 v2 challenge on /api/v1/capabilities/*/invoke, and https://www.tereno.xyz/openapi.json).

  • Ran python3 -m unittest discover -s tests (38 passed) and python3 scripts/build-distributions.py dist.

  • Confirmed git diff --check and verified SSH commit signature.

  • Generated portable manifest and MCP config validate against the vendored Agent Plugins schemas

  • Package paths and skill references remain inside each generated plugin root

  • Marketplace, skills, MCP, and icon paths are valid

  • Exactly one canonical skill library; generated copies are not committed

  • Claude compatibility metadata/endpoint and marketplace sources agree with the portable package

  • Tool schemas, authorization, and retry behavior reviewed

  • README and changelog updated; versions consistent (not modified per Wallet MCP plugin Contribution Scope)

  • No unapproved disclosures or sensitive data

  • Signed commits

Base / Wallet MCP Plugin Submission Agreement

By checking the box below, I agree and represent on behalf of the protocol/entity it references that:

  • I am authorized to submit this plugin on behalf of the protocol/entity it references;

  • the plugin does not infringe or misappropriate any third party's rights;

  • the plugin and the underlying protocol comply with all applicable laws, and my API enforces the same geofencing and eligibility restrictions as my own user-facing app;

  • the plugin is in full compliance with our protocol's/entity's then-current terms and conditions, and if not, submission and use thereafter is considered a formal written exemption to such terms and conditions;

  • the plugin accurately describes its behavior and contains no hidden, deceptive, or malicious instructions, and my API will not return malicious or unexpected calldata;

  • the protocol/entity is solely responsible for the plugin, and submitting a plugin is subject to the applicable terms of service as using a "Service"; and

  • Base may modify, decline to list, or remove the plugin at any time, for any reason.

  • I have read and agree to the Base MCP Plugin Submission Agreement above.

Release considerations

Third-party Wallet MCP plugin addition only (skills/wallet-mcp/plugins/tereno.md). requires.allowlist: [www.tereno.xyz] is declared for web_request provisioning upon maintainer acceptance.

@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
1 if authored by an app that is not allowlisted and lacks verified human attribution 0
Sum 1

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants