Skip to content

feat(agentkit): add Tereno action provider for Base pre-action verification & intelligence - #1621

Open
RobMartello wants to merge 1 commit into
coinbase:mainfrom
RobMartello:feat/add-tereno-action-provider
Open

RobMartello wants to merge 1 commit into
coinbase:mainfrom
RobMartello:feat/add-tereno-action-provider

Conversation

@RobMartello

Copy link
Copy Markdown

Description

Adds the **Tereno** Action Provider (`@coinbase/agentkit`), enabling autonomous
agents on Base to perform sub-second, pre-action verification, smart contract risk
auditing, token metadata inspection, and prediction market evidence retrieval over
x402 micropayments.

### Capabilities Included:
- `tereno_check_contract`: Pre-action contract verification (verdict: `allow` /
`review` / `block`, bytecode integrity, EIP-1967 proxy implementation changes, and
pause status).
- `tereno_get_token_metadata`: Block-fresh ERC-20 token metadata (name, symbol,
decimals, total supply).
- `tereno_get_chain_snapshot`: Latest block, timestamp, base fee, and gas
recommendations.
- `tereno_get_prediction_evidence`: Machine-readable evidence context for prediction
market propositions.
- `tereno_quote_contract_guard`: Cost quote and credit evaluation before running
checks.
- `tereno_list_capabilities`: Active capability schemas, operational TTL windows, and
pricing tiers.
- `tereno_list_bounties`: List available open verification bounties on Base.
- `tereno_publish_contract_fingerprint`: Seed verification caches to earn reuse
dividends.

Supported networks: **Base** (`8453`) and **Base Sepolia** (`84532`).

## Tests

Unit tests executed for schema validation and network support via Jest:
```bash
npx jest src/action-providers/tereno/terenoActionProvider.test.ts

Output:

PASS src/action-providers/tereno/terenoActionProvider.test.ts
  TerenoActionProvider Schemas
    TerenoCheckContractSchema
      ✓ should successfully parse a valid Base EVM address (8 ms)
      ✓ should reject an invalid address format (2 ms)
    TerenoGetTokenMetadataSchema
      ✓ should parse valid token address (1 ms)
    TerenoGetPredictionEvidenceSchema
      ✓ should parse a valid prediction question (2 ms)
      ✓ should reject too short question (1 ms)
    TerenoListBountiesSchema
      ✓ should apply default limit of 20 (1 ms)
  TerenoActionProvider
    ✓ should be an instance of TerenoActionProvider (1 ms)
    ✓ should support Base mainnet and Base Sepolia (1 ms)

Test Suites: 1 passed, 1 total
Tests:       8 passed, 8 total

Checklist

[✓] Added documentation to all relevant README.md files (typescript/agentkit/README.md)
[✓] Added a changelog entry (.changeset/add-tereno-action-provider.md)

@cb-heimdall

cb-heimdall commented Nov 4, 2026 •

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

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Nov 4, 2026
@RobMartello
RobMartello force-pushed the feat/add-tereno-action-provider branch from 0d90417 to d79b6e6 Compare November 4, 2026 11:55

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

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants