# Submitting Vaultfire to Coinbase AgentKit

## Two Paths to Get Coinbase's Attention

### Path 1: Direct PR to coinbase/agentkit (Recommended)

This is how Compound, Pyth, and every other built-in action provider got included.
The Vaultfire provider follows the exact same patterns they use internally.

**Steps:**

1. **Fork** [coinbase/agentkit](https://github.com/coinbase/agentkit)
2. **Copy the provider** into their structure:
   ```
   python/coinbase-agentkit/coinbase_agentkit/action_providers/vaultfire/
   ├── __init__.py
   ├── vaultfire_action_provider.py
   ├── constants.py
   └── schemas.py
   ```
3. **Add tests** under their test directory
4. **Update the changelog**
5. **Open a PR** with:
   - Title: `feat: Add Vaultfire action provider — on-chain trust for AI agents`
   - Link to the standalone package repo for reference
   - Include test output and screenshots

**PR maintainers** (tag these people):
- @John-peterson-coinbase
- @stat
- @rohan-agarwal-coinbase
- @0xRAG
- @yuga-cb

**PR review timeline:** Initial response within 1 day, review within 1 day.

All commits must be signed (required by Coinbase).

### Path 2: Standalone Package + Community Showcase

Ship `vaultfire-agentkit` to PyPI and promote it:

1. **Publish to PyPI**: `pip install vaultfire-agentkit`
2. **Submit to AgentKit Showcase**: Open an issue on coinbase/agentkit with the `showcase` label
3. **Post on Coinbase Developer Forum**: [cdp.coinbase.com/community](https://docs.cdp.coinbase.com)
4. **Tag on X/Twitter**: @BuildOnCDP, @CoinbaseDev, @jessepollak

## What Makes This Compelling for Coinbase

The pitch is simple: **AgentKit gives agents a wallet. Vaultfire gives them an identity and trust.**

Key selling points:
- **Native Base support** — Coinbase's own L2, and Vaultfire's primary chain
- **ERC-8004 standard** — not a custom solution, implements the Ethereum standard for agent identity
- **Fills a gap** — no existing AgentKit provider handles agent identity, reputation, or accountability
- **Same patterns** — built using `ActionProvider`, `@create_action`, Pydantic schemas, `EvmWalletProvider` — identical to Compound, Basename, Pyth providers
- **4-chain coverage** — Base, Avalanche, Arbitrum, Polygon (103 verified contracts)
- **Security audited** — 5 rounds, 0 critical/high/medium/low findings
- **Working tests** — 33 passing, including automated security scan

## Draft PR Description

```
## Summary

Adds a Vaultfire action provider that gives AgentKit agents on-chain trust
infrastructure through the Vaultfire Protocol (ERC-8004 implementation).

## Actions Added

### Write Actions
- `register_agent` — Register an ERC-8004 agent identity on-chain
- `create_accountability_bond` — Stake native tokens as accountability guarantee
- `create_partnership_bond` — Create mutual trust bond between two agents

### Read Actions
- `get_trust_profile` — Full trust profile (identity + reputation + VNS)
- `get_reputation` — On-chain reputation score and ratings
- `resolve_vns` — Vaultfire Name Service name ↔ address resolution
- `get_bond` — Bond details by ID

## Networks Supported
- Base (base-mainnet) — primary
- Arbitrum (arbitrum-mainnet)
- Polygon (polygon-mainnet)
- Avalanche (avalanche-mainnet)

## Why This Matters

Every AI agent using AgentKit gets a wallet, but currently has no way to:
- Prove its identity to other agents or protocols
- Demonstrate accountability through stake-backed commitments
- Build verifiable reputation over time
- Discover and verify other agents before transacting

Vaultfire fills this gap using ERC-8004, the first Ethereum standard
for AI agent identity (co-authored by MetaMask, Google, Coinbase, EF).

## Testing

33 unit tests covering:
- Provider instantiation and action discovery (7 actions)
- Network support (Base, Arbitrum, Polygon, Avalanche — rejects unsupported)
- Schema validation for all actions
- Contract address checksum verification
- Security scan (no secrets in source)
- Write action simulation with mocked wallet

## Protocol Info
- Website: https://theloopbreaker.com
- Contracts: 103 verified across 4 chains
- Audit: 5 rounds, 0C/0H/0M/0L remaining
- Repo: https://github.com/Ghostkey316/vaultfire-agentkit
```

## Coinbase Developer Relations Contacts

The CDP team is active on:
- **GitHub**: coinbase/agentkit (Issues, PRs, Discussions)
- **X/Twitter**: @BuildOnCDP, @CoinbaseDev, @jessepollak, @YugaCohler
- **Discord**: Coinbase Developer Discord
- **Forum**: docs.cdp.coinbase.com

## Base Ecosystem Grants

Vaultfire is a strong candidate for Base ecosystem support:
- https://base.org/grants
- Apply through the Optimism governance process
- Vaultfire fits the "AI Infrastructure" and "Developer Tooling" categories
