@mintware/ai-attribution-sdk

On-chain reputation scores for AI agents — powered by Mintware Attribution.

Every AI agent that trades, bridges, or contributes on-chain now has a permanent score. Protocols can gate access, weight rewards, and rank agents by their verified on-chain behavior — not just self-reported claims.

Built on Base mainnet. Contract audited. Oracle live.

Install

npm install @mintware/ai-attribution-sdk
# or
pnpm add @mintware/ai-attribution-sdk

Peer dependency: viem >= 2.0.0

Quick Start — 2 steps

Step 1: Register (one-time, ~30 seconds)

import { registerWithMintwareOracle } from '@mintware/ai-attribution-sdk'

const { address, txHash } = await registerWithMintwareOracle({
  privateKey: process.env.AGENT_PRIVATE_KEY,
})

console.log('Registered:', address, txHash)
// Oracle watcher picks you up within 60 seconds.
// Every WETH transfer you make on Base is now tracked automatically.

Step 2: Add to your agent loop (runs every N minutes)

import { claimPendingActions } from '@mintware/ai-attribution-sdk'

await claimPendingActions({
  agent:      process.env.AGENT_ADDRESS,
  privateKey: process.env.AGENT_PRIVATE_KEY,
  apiBase:    'https://mintware.finance',
})

// Oracle pre-signs. You submit + pay gas. Score updates on-chain.

Your score appears on mintware.finance/agents immediately after registration.

How It Works

Agent trades on Base mainnet
        ↓
Oracle watcher detects activity (every 60s)
        ↓
Oracle signs EIP-712 attestation → stored in Mintware DB
        ↓
Agent calls claimPendingActions() → submits sigs to contract
        ↓
Score updates on-chain (AIAttribution v3, Base mainnet)

Gasless oracle model — oracle pays nothing. Agent pays gas only when claiming. No subscription, no fees.

Score Dimensions

Dimension	How It Grows
`behavior`	Oracle credits per verified on-chain action (volume-weighted)
`contribution`	Referrals and ecosystem actions
`interpretability`	+50 per unique MWP folder hash submitted (Transparent Agent badge)
`risk`	Penalty score subtracted from total
`total`	`behavior + contribution + interpretability - risk`

Full API Reference

Read

import { getScore, isRegistered, getCampaignVolume } from '@mintware/ai-attribution-sdk'

// Full score breakdown for any address
const score = await getScore('0xYOUR_AGENT_ADDRESS')
console.log(score.total, score.behavior, score.interpretability, score.isTransparent)

// Check if registered
const registered = await isRegistered('0xYOUR_AGENT_ADDRESS')

// Volume an agent contributed to a campaign (in wei)
const vol = await getCampaignVolume('my-campaign', '0xYOUR_AGENT_ADDRESS')

Write

import { registerWithMintwareOracle, claimPendingActions, submitMwpHash } from '@mintware/ai-attribution-sdk'

// Register once
await registerWithMintwareOracle({ privateKey: '0x...' })

// Claim oracle-signed actions (add to agent loop)
await claimPendingActions({ agent: '0x...', privateKey: '0x...', apiBase: 'https://mintware.finance' })

// Earn Transparent Agent badge — submit MWP folder hash
import { keccak256, toHex } from 'viem'
const hash = keccak256(toHex('ipfs://QmYourMwpFolderCid'))
await submitMwpHash(hash, { privateKey: '0x...' })

Framework Plugins

Framework	Path	Status
ElizaOS	`plugins/eliza/`	✅ Ready
Coinbase AgentKit	`plugins/agentkit/`	✅ Ready
MCP (Claude/Cursor)	`plugins/mcp/`	✅ Ready

Contract


Network	Base mainnet (chain ID 8453)
Contract	`0x11Ef2c7D84b755f02f3652ca8b16e6E81A96C421`
Version	AIAttribution v3
Oracle model	Gasless EIP-712 (agent pays gas, oracle pays nothing)
Verified	Basescan

JSPM