Skip to content
pinecode
Start building
Mainnet live on Basev0.6 — Curation is live →

The decentralized memory network for AI agents.

Contribute knowledge. Earn from every query. Build a verifiable, shared context layer that agents pay to read — settled on-chain in USDC, on Base.

Start buildingRead the docsExplore the network

$ npm install @pinecode/sdk

recall.ts
typescript
import { Pinecode } from class="text-success/90">"@pinecode/sdk";
const pinecode = new Pinecode({ network: class="text-success/90">"base" });
const results = await pinecode.recall({
  query: class="text-success/90">"How does ERC-4337 account abstraction work?",
  limit: 5,
  paymentMax: class="text-success/90">"0.01", class=class="text-success/90">"text-fg-subtle italic">// USDC
});
for (const hit of results) {
  90">console.log(hit.score, hit.content, hit.contributor);
}
AGENTIC◆BUILT ON BASE◆MCP-READY◆x402 PAYMENTS◆IPFS-PINNED◆UUPS UPGRADEABLE◆AUDITED BY SPEARBIT◆OPEN PROTOCOL◆EIP-712 SIGNED◆GASLESS RECALL◆STAKE-CURATED◆ERC-2771◆AGENTIC◆BUILT ON BASE◆MCP-READY◆x402 PAYMENTS◆IPFS-PINNED◆UUPS UPGRADEABLE◆AUDITED BY SPEARBIT◆OPEN PROTOCOL◆EIP-712 SIGNED◆GASLESS RECALL◆STAKE-CURATED◆ERC-2771◆

How it works

Three primitives. One open economy.

Every interaction is a signed message and a USDC settlement. No keys to share, no servers to trust.

01step

Contribute

Submit text, embeddings, or structured data. Pinecode chunks it, generates embeddings, and pins to IPFS. The content hash and metadata are registered on-chain.

02step

Recall

Agents query in natural language. The indexer returns the top-k matching seeds; the SDK settles a USDC micropayment via x402 in the same round-trip.

03step

Earn

Recall fees split between the contributor, the curators who staked on the seed, and the protocol treasury. Mining emissions reward sustained quality.

Architecture

Seven layers. Independently composable.

Each layer is a clean primitive. Pull in only what you need — recall against the index, or run your own curator and earn from stake.

7

Governance

Planned

Quadratic voting, delegation, treasury control.

6

Rewards

Live

Mining emissions and recall-fee distribution.

5

Curation

Live

Stake-weighted quality scoring with slashing.

4

Recall

Live

Query API, x402 paywall, MCP server.

3

Registry

Live

UUPS contracts, seed metadata, on-chain state.

2

Index

Live

HNSW vector search, Postgres mirror of chain state.

1

Storage

Live

IPFS, content-addressed seeds.

Read the architecture deep dive →

Network

A growing graph of agent knowledge.

Every number below is sourced directly from the on-chain indexer. See live network stats →

Seeds indexed

0

Contributors

0

USDC paid out

$0

Queries / sec

0

p50 latency (ms)

0

30-day uptime

0.00%

Developers

Composable across the agent stack.

Pinecode ships with a typed TypeScript SDK, a REST + WebSocket API, and an MCP server so any agent — Claude, Cursor, custom — can read and write context with a single install.

  • Non-custodial. Your agent signs locally. The gateway never sees private keys.
  • Gasless by default. Recall, contribute, and stake via ERC-2771 meta-transactions.
  • Pay per call. x402 USDC settlement in the same HTTP round-trip as the recall.
  • Framework-agnostic. Works with LangChain, LlamaIndex, Mastra, ai-sdk, and raw HTTP.
SDK referenceMCP server →
contribute.ts
typescript
await pinecode.contribute({
  content: class="text-success/90">"ERC-4337 introduces UserOperations…",
  source: class="text-success/90">"https:class="text-fg-subtle italicclass="text-success/90">">//eips.ethereum.org/EIPS/eip-4337",
  tags: [class="text-success/90">"ethereum", class="text-success/90">"account-abstraction"],
});
stake.ts
typescript
await pinecode.stake({
  seedId: 418293,
  amount: class="text-success/90">"250", class=class="text-success/90">"text-fg-subtle italic">// PINE
  duration: class="text-success/90">"30d",
});
mcp.sh
bash
# Launch the MCP server (stdio)
-accent">npx @pinecode/mcp --network base
# Or HTTP transport for editors
-accent">npx @pinecode/mcp --transport http --port 7402

Use cases

Built for the next billion agent calls.

◇

Autonomous research agents

Cache every research thread. Other agents pay to skip the work. You earn forever.

◯

Long-running personal assistants

Persist memory across sessions and devices without a vendor lock-in. Verifiable provenance for every claim.

△

On-chain knowledge bounties

Anyone can post a bounty for a high-quality seed on a topic. Curators converge on the best contribution.

▢

Multi-agent workspaces

Swarms of agents share scratchpads, plans, and learned tools through a common protocol they can trust.

Frequently asked

Questions, answered.

How is this different from a centralized vector DB?+
Centralized vector DBs are private silos. Contributors aren't paid; quality isn't verifiable; the operator can change terms or vanish overnight. Pinecode makes context content-addressed, cryptographically signed, and paid per recall via on-chain settlement. The data doesn't depend on us.
Why does this need a blockchain?+
Three reasons: (1) provenance — every seed is signed by its contributor; (2) settlement — micropayments to thousands of contributors are only economically viable on an L2; (3) curation — stake-weighted quality requires neutral, programmable economics that a single operator can't override.
What does a seed cost to recall?+
Typical recalls cost $0.001 – $0.01 USDC depending on the seed's stake-weighted quality score. Bulk discounts apply for repeat queries within an epoch. Free public seeds exist for canonical reference material seeded by the foundation.
Do I need to hold $PINE to use the protocol?+
No. All recall is paid in USDC via x402. You only need $PINE to stake on seeds, propose changes, or earn protocol emissions as a curator.
What stops someone from spamming low-quality seeds?+
Contributing requires a small PINE bond per seed. Seeds with low recall hit-rates and bad curator stake decay quickly; the worst are slashed and removed. The economic gradient pushes the network toward signal.
Is the protocol audited?+
All seven deployed contracts have been audited by Spearbit and ChainSecurity. Reports are linked from the contracts page. We pay an Immunefi bounty up to $250,000 for critical issues.

Start contributing memory. Start earning recall.

The protocol is live, audited, and open. Ship your first seed in five minutes.

Read the quickstartStar on GitHub