പ്രധാന ഉള്ളടക്കത്തിലേക്ക് കടക്കുക
കൽപ്പന ചെയ്യുകഗൈഡുകൾനിങ്ങളുടെ ഏജന്റ് വാലറ്റ് സുരക്ഷിതമാക്കുക
ഗൈഡ്

ലൈവ് പോകുന്നതിന് മുമ്പ് നിങ്ങളുടെ ഏജന്റ് വാലറ്റ് സുരക്ഷിതമാക്കുക.

15 മിനിറ്റ്
ചുരുക്കം ഉത്തരം

ഏജന്റ് പേയ്മെന്റുകളുമായി ഉൽപ്പന്നത്തിലേക്ക് പോകുന്നത് സാധാരണ API ഇന്റഗ്രേഷനുമായി സമാനമായ ചെക്ക്ലിസ്റ്റ് അല്ല. ചേർക്കുക: ഒരു ഉദ്ദേശ്യ വാലറ്റ്-തരം തിരഞ്ഞെടുപ്പ്, ഒരു ക്രമീകരിച്ച ചെലവിടൽ നയം (ഡിഫോൾട്ടുകൾ അല്ല), ഒരു വ്യക്തമാക്കിയ കേഡൻസിൽ APIയും വെബ്‌ഹുക്ക് രഹസ്യത്തിന്റെ റൊട്ടേഷൻ, ഒരു ആഴ്ചയിൽ ഒരു തവണ പരിശോധിച്ച ഓഡിറ്റ്-ലോഗ്, ഒരു സംഭവ-പ്രതികരണ റൺബുക്ക്. ഇതുമില്ലാതെ, നിങ്ങൾ ഷിപ്പ് ചെയ്യുന്നു, കഠിനമായ രീതിയിൽ പഠിക്കുന്നു.

മുൻകൂർ ആവശ്യങ്ങൾ

നിങ്ങൾ തുടങ്ങുന്നതിന് മുമ്പ്.

  • ടെസ്റ്റിൽ എണ്ടു-ടു-എൻഡ് പ്രവർത്തിക്കുന്ന ഏജന്റ് ഇന്റഗ്രേഷൻ - add-payments-to-agentയും test-without-real-moneyയും കാണുക.
  • ചെലവഴിക്കൽ നിയന്ത്രണങ്ങൾ ക്രമീകരിച്ചിരിക്കുന്നു - ചെലവഴിക്കൽ നിയന്ത്രണങ്ങൾ കാണുക (ഈ ഗൈഡ് ഒരു നയം ഇതിനകം നിലവിലുണ്ടെന്ന് കരുതുന്നു).
  • ഒരു രഹസ്യ മാനേജർ (AWS Secrets Manager, GCP Secret Manager, Vault, 1Password, മുതലായവ) - .env ഫയലുകളിൽ രഹസ്യങ്ങൾ മതിയല്ല.
  • വാലറ്റ് ഡാഷ്ബോർഡിലേക്ക് അഡ്മിൻ ആക്സസ് ഉള്ള വ്യക്തമായി തിരിച്ചറിയപ്പെട്ട ഓൺ-കാൾ എഞ്ചിനീയർ.
  • 15 മിനിറ്റ് ശ്രദ്ധ കേന്ദ്രീകരിച്ച സമയം. താഴെയുള്ള ചെക്ക് ലിസ്റ്റ് ആഗ്രഹിക്കുന്നതല്ല - ഓരോ വരിയിലും പ്രവർത്തിക്കുക.
ചുവടു 1 OF 4

പ്രീലോഞ്ച് ചെക്ക്ലിസ്റ്റ് നടത്തുക.

പതിനൊന്ന് ഇനം. ഓരോന്നും ഒരു യേശ്/ഇല്ല ചോദ്യം ആണ്, ഒരു ഏക ഉടമയുണ്ട്. ഏതെങ്കിലും ഇനം പരിശോധിക്കാത്ത പക്ഷം, ലൈവ് ആകാൻ പോകരുത് - ആദ്യം ആ ഇനം പൂർത്തിയാക്കുക. ഉൽപ്പന്നത്തിൽ ഒരു ഇനം നഷ്ടപ്പെടുന്നതിന്റെ ചെലവ് എപ്പോഴും ഇപ്പോൾ അത് പൂർത്തിയാക്കുന്നതിന്റെ ചെലവിൽ കൂടുതലാണ്.

# Pre-launch security checklist for agent wallets.

[ ] Wallet type chosen with reasoned trade-offs (smart wallet vs EOA).
[ ] Spend permission set in the dashboard: an allowance per period + a per-transaction cap.
[ ] API keys scoped to the minimum the agent needs (read_wallet_metadata / pay_bills / receive_money).
[ ] All API keys stored in a secret manager (not env files committed to git).
[ ] Test keys and live keys cannot be swapped (boot-time prefix check in place).
[ ] Webhook secret rotated within the last 90 days (webhooks.rotateSecret).
[ ] Webhook URL pointed at production, not a tunnel.
[ ] Audit review scheduled; alerting in place for unusual events.
[ ] A spike of rejected payments triggers an alert (>5/hour from one agent).
[ ] Incident runbook exists, has been read by someone other than the author.
[ ] One person other than you knows how to revoke an API key in < 5 minutes.
ചുവടു 2 OF 4

API കീയും വെബ്‌ഹുക്ക് രഹസ്യം മാറ്റാൻ ഷെഡ്യൂൾ ചെയ്യുക.

ത്രൈമാസം ഡിഫോൾട്ട് കേഡൻസ് ആണ്; സംശയാസ്പദമായ ചോർച്ച, ലീഡ് എഞ്ചിനീയർ വിടവ്, കമ്പനിയില elsewhere സുരക്ഷാ സംഭവങ്ങൾ എന്നിവയിൽ ഉടൻ റൊട്ടേറ്റ് ചെയ്യുക. രണ്ട് കീ വിൻഡോ മാതൃക നിങ്ങൾക്ക് കീകൾ ശൂന്യമായ ഡൗൺടൈം കൂടാതെ മാറ്റാൻ അനുവദിക്കുന്നു: പുതിയ കീ സൃഷ്ടിക്കുക, അത് എല്ലായിടത്തും വിന്യസിക്കുക, സ്ഥിരീകരിക്കുക, പിന്നെ പഴയത് റിവോക്ക് ചെയ്യുക.

TypeScript
// One-time key rotation script. Run quarterly, on lead departure, on suspected leak.
import { createClient } from "@blockchain0x/node";

const client = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });

async function rotate() {
  // Scope the new key to only what the agent needs.
  const fresh = await client.apiKeys.create({
    name: `prod-${new Date().toISOString().slice(0, 10)}`,
    scopes: ["read_wallet_metadata", "pay_bills", "receive_money"],
  });
  console.log("NEW KEY:", fresh.secret);            // Store in secret manager NOW.

  // Wait until the new key is deployed and verified working, THEN:
  // await client.apiKeys.revoke(OLD_KEY_ID);   // (or apiKeys.rotate in one call)
}
Python
# One-time key rotation script. Run quarterly, on lead departure, on suspected leak.
from blockchain0x import Client
import datetime, os

client = Client()  # reads BLOCKCHAIN0X_API_KEY

def rotate():
    fresh = client.api_keys.create(body={
        "name": f"prod-{datetime.date.today().isoformat()}",
        "scopes": ["read_wallet_metadata", "pay_bills", "receive_money"],
    })
    print("NEW KEY:", fresh["secret"])   # Store in secret manager NOW.

    # Wait until new key is deployed and verified, THEN:
    # client.api_keys.revoke(OLD_KEY_ID)   # (or api_keys.rotate in one call)

വെബ്‌ഹുക്ക് സൈൻ ചെയ്യൽ രഹസ്യങ്ങൾ ഡാഷ്ബോർഡിലൂടെ സമാനമായി ചലിക്കുന്നു - രണ്ടാമത്തെ രഹസ്യം സജീവമാക്കുക, ഏതെങ്കിലും സ്വീകരിക്കാൻ ഹാൻഡ്ലർ വീണ്ടും വിന്യസിക്കുക, തുടർന്ന് പഴയത് വിരമിക്കുക. രണ്ട് കാൽക്കാലികമായ ചക്രത്തിൽ കലണ്ടർ ഓർമ്മപ്പെടുത്തലുകൾക്കൊപ്പം.

ചുവടു 3 OF 4

ആഴ്ചയിൽ ഒരു ഓഡിറ്റ് അവലോകനം സജ്ജമാക്കുക.

പ്രതിവാരവും ശ്രദ്ധിക്കേണ്ട മൂന്ന് കാര്യങ്ങൾ: പുതിയ പ്രതിപക്ഷങ്ങൾ (മുമ്പ് കാണാത്ത ഏതെങ്കിലും 30-സെക്കൻഡ് സാനിറ്റി പരിശോധനയ്ക്ക് അർഹമാണ്), നിരസിച്ച കൈമാറ്റങ്ങൾ (ചെലവിടുന്ന അനുമതി അതിന്റെ ജോലി ചെയ്തു - ഏജന്റ് എവിടെയോ കുടുങ്ങിയോ?), ഓഫ്ഹവേഴ്സ് കൈമാറ്റങ്ങൾ (ഒരു ഏജന്റിൽ നിന്ന് 3am-ൽ ഒരു കൈമാറ്റം, സാധാരണയായി ബിസിനസ് മണിക്കൂറുകൾ മാത്രം പ്രവർത്തിക്കുന്നതുകൊണ്ട്, എപ്പോഴാണ് ഇഞ്ചക്ഷൻ ആക്രമണങ്ങളെ നേരത്തെ പിടികൂടുന്ന തരത്തിലുള്ള സിഗ്നൽ).

TypeScript
// Weekly audit query over the webhook events YOU persisted (payment.received /
// payment.sent). There is no transactions.list API - your own store is the log.
const since = Date.now() - 7 * 24 * 60 * 60 * 1000;
const events = await db.paymentEvents.findMany({ where: { receivedAt: { gte: since } } });

const newCounterparties = events.filter((e) => e.counterpartyFirstSeen);
const offHours = events.filter((e) => {
  const h = new Date(e.receivedAt).getUTCHours();
  return h < 5 || h > 22;
});

// Reconcile anything that looks off against the chain:
// const tx = await client.transactions.get(event.txHash);
console.log({ newCounterparties, offHours });
Python
from datetime import datetime, timedelta, timezone

# Query your own persisted webhook events - the SDK has transactions.get(id),
# not a list endpoint, so your event store is the audit log.
since = datetime.now(timezone.utc) - timedelta(days=7)
events = db.payment_events.where(received_at__gte=since)

new_counterparties = [e for e in events if e.counterparty_first_seen]
off_hours = [e for e in events if not (5 <= e.received_at.hour <= 22)]

# Reconcile against the chain when something looks off:
# tx = client.transactions.get(event.tx_hash)
print({"new_counterparties": new_counterparties, "off_hours": off_hours})
ചുവടു 4 OF 4

സംഭവ റൺബുക്ക് എഴുതുക (മുറിക്കുക).

ഒരു റൺബുക്ക് എത്രത്തോളം അടുത്തിടെ പരീക്ഷിച്ചതിന്റെ അടിസ്ഥാനത്തിലാണ് നല്ലത്. താഴെ ടെംപ്ലേറ്റ് ആണ് - ഇത് നിങ്ങളുടെ ടീമിന്റെ വിക്കിയിൽ പകർപ്പിക്കുക, നിങ്ങളുടെ പ്രത്യേകതകൾക്കായി എഡിറ്റ് ചെയ്യുക, അടുത്ത ക്വാർട്ടറിൽ 30 മിനിറ്റ് ഡ്രിൽ ഷെഡ്യൂൾ ചെയ്യുക. സമയം; ഡ്രിൽ കാണിക്കുന്ന ഏതെങ്കിലും കാര്യങ്ങൾ പരിഹരിക്കുക.

# Incident response runbook - Agent wallet compromise (suspected or confirmed)

## Trigger
Any of:
- Unrecognised counterparty receiving > $10 USDC.
- > 50 rejected payment attempts from one agent in an hour.
- Engineer reports they cannot account for a recent payment.
- A leaked API key surfaces in a public scan.

## Step 1 - Stop the bleeding (< 5 minutes)
- Revoke the suspect API key: dashboard, or apiKeys.revoke / apiKeys.rotate.
- Revoke the agent's spend permission in the dashboard (allowance to zero).
- A revoked key cannot move funds and a revoked permission authorizes nothing.

## Step 2 - Preserve evidence (< 15 minutes)
- Pull the last 24h from the dashboard activity log and your stored events.
- Note the agent's spend permission as it was at the time of the incident.
- Note the timestamps of any unrecognised payments and their txHash on Base
  (fetch with transactions.get).

## Step 3 - Communicate (< 30 minutes)
- Inform the on-call lead and finance.
- If customer funds are affected, draft a notification template (do not send
  until investigation is far enough along to be accurate).

## Step 4 - Root cause and remediation (24-72 hours)
- Determine: leaked key, compromised webhook secret, prompt-injection
  bypass, integration bug, or other.
- Rotate every secret that could have been exposed.
- Tighten the spend permission (lower the allowance or per-transaction cap).
- File a post-mortem with timeline, RCA, and follow-ups.
സാധാരണ പിഴവുകൾ

ടീമുകൾ അവരുടെ ആദ്യ ഉൽപ്പന്ന സംഭവത്തിൽ പിടിക്കുന്ന അഞ്ചു കാര്യങ്ങൾ.

പുതിയ ഏജന്റിനെ 'മുമ്പത്തെ പോലെ' പരിഗണിക്കുന്നു

ഓരോ ഏജന്റിനും അതിന്റെ സ്വന്തം പ്രൊഫൈൽ, അതിന്റെ സ്വന്തം കീകൾ, അതിന്റെ സ്വന്തം ചെലവു നയം ലഭിക്കുന്നു. നിങ്ങൾ 'അവയെ സമാനമായതിനാൽ' ഏജന്റുകൾക്കിടയിൽ കീകൾ പുനരുപയോഗിക്കുന്നുവെങ്കിൽ, ഒരു ഏകീകൃത കീ കംപ്രോമൈസ് ഓരോ ഏജന്റിനെയും ഒരുമിച്ച് ബാധിക്കുന്നു. ഒരു പുതിയ ഏജന്റ് പ്രൊഫൈൽ സൃഷ്ടിക്കുന്നത് ഒരു API വിളി എടുക്കുന്നു; ഓരോ ഏജന്റിന്റെ ഐസൊലേഷൻ ഇത് ശരിയായി ചെയ്യുന്നതിന് ചെലവായ ഒരു മിനുട്ടിന് വിലമതിക്കുന്നു.

ഡാറ്റയാൽ അല്ല, അനുമതി കണക്കാക്കൽ പ്രകാരം ചെലവഴിക്കുക

ഒരു অনুমാനത്തിൽ നിന്ന് അനുവദനം, ഇടപാടിന്റെ പരിമിതിയേയും തിരഞ്ഞെടുക്കുക, രണ്ടിൽ ഒന്നും സംഭവിക്കുന്നു: വളരെ താഴ്ന്നത്, ഏജന്റ് 'പണമടവ് തള്ളിയതായി' ഡീബഗ് ചെയ്യുമ്പോൾ ഓരോ ദിവസവും മധ്യത്തിൽ പരിധി അടിച്ചേൽക്കുന്നു; വളരെ ഉയർന്നത്, നിയന്ത്രണം നാടകമാണ്. ആദ്യ ആഴ്ചയിൽ, യഥാർത്ഥ പ്രതിദിന ചെലവുകൾ കാണുക, അനുവദനം 2-3x ആകണം - 1x (വളരെ കർശനമായത്) അല്ലെങ്കിൽ 100x (പ്രായോഗികമായി അനന്തമായത്) അല്ല. ഇത് ഒരു ഡാഷ്ബോർഡ് മാറ്റമാണ്, അതിനാൽ പുനഃക്രമീകരണം വിലക്കുറവാണ്.

വെബ്‌ഹുക്ക് ഒപ്പിടൽ രഹസ്യം ഒരിക്കലും മാറ്റിയിട്ടില്ല

വെബ്‌ഹുക്ക് രഹസ്യം漏ചെയ്യുന്ന ഒരു സംഭവം ഒരു ആക്രമണകാരൻ നിയമപരമായ payment.received ഇവന്റുകളെ പോലെ കാണുന്ന വെബ്‌ഹുക്കുകൾ നിർമ്മിക്കാൻ കഴിയും, ഇത് നിങ്ങളുടെ ഹാൻഡ്ലറെ ഒരിക്കലും പണമിടപാട് ചെയ്തിട്ടില്ലാത്ത ജോലികൾ നൽകാൻ തട്ടിപ്പു ചെയ്യാം. API കീകളുടെ സമാനമായ കാഡൻസിൽ രഹസ്യം (webhooks.rotateSecret) മാറ്റുക (മാസത്തിൽ ഒരിക്കൽ) അല്ലെങ്കിൽ നിങ്ങൾക്ക് വെളിപ്പെടുത്തൽ സംശയമുള്ളപ്പോൾ, എല്ലായ്പ്പോഴും deliveries-നെ നിലവിലെ രഹസ്യത്തിന് എതിരെ webhooks.verify ഉപയോഗിച്ച് സ്ഥിരീകരിക്കുക.

എവിടെയും വായിക്കാത്ത ഓഡിറ്റ് ലോഗുകൾ

ഒരു ഓഡിറ്റ് ലോഗ് ആരെങ്കിലും അതിലേക്ക് നോക്കുമ്പോൾ മാത്രമേ കാര്യങ്ങൾ പിടിച്ചെടുക്കൂ. കൂടുതലായും ടീമുകൾ ലോഗ് സജീവമാക്കുന്നു, ഒരിക്കലും അതിലേക്ക് നോക്കുന്നില്ല, ഉപഭോക്തൃ പരാതികളിൽ നിന്ന് പ്രശ്നങ്ങളെക്കുറിച്ച് അറിയുന്നു. ഒരു ആഴ്ചയിൽ 15 മിനിറ്റ് അവലോകനം ഷെഡ്യൂൾ ചെയ്യുക: പുതിയ പ്രതിപക്ഷങ്ങൾ, നിരസിച്ച പണമിടപാടുകൾ, ഓഫ്സ്-ഹവേഴ്സ് പണമിടപാടുകൾ. ചെലവ് ചെറുതാണ്; കണ്ടെത്താനുള്ള സമയം ആഴ്ചകളിൽ നിന്ന് ദിവസങ്ങളിലേക്ക് കുറയുന്നു.

സംഭവ റൺബുക്കിൽ ഡ്രിൽ ഇല്ല

ഒരിക്കലും പ്രയോഗിക്കാത്ത ഒരു റൺബുക്ക് കൃത്രിമമാണ്. ഒരു ക്വാർട്ടർ തീയതി തിരഞ്ഞെടുക്കുക, ഒരു ചോർന്ന കീ സീനാരിയോ സിമുലേറ്റ് ചെയ്യുക, റിവോക്ക് ചെയ്യാനും അടയ്ക്കാനും എത്ര സമയം എടുക്കുന്നു എന്ന് സമയം കണക്കാക്കുക. ആദ്യത്തെ ഡ്രിൽ എപ്പോഴും എന്തെങ്കിലും നഷ്ടമായതായി വെളിപ്പെടുത്തുന്നു (മറിച്ചറിയാൻ എങ്ങനെ എന്നറിയുന്ന എഞ്ചിനീയർ അവധിയിൽ ആണ്, റൺബുക്ക് കാലഹരണപ്പെട്ട Notion ലിങ്കിന് പിന്നിലാണ്). യാഥാർത്ഥ്യത്തിൽ സംഭവിക്കുന്ന ഒരു സംഭവത്തിൽ 3am-ൽ കണ്ടെത്തുന്നതിന് മികച്ചതാണ്.

അടുത്ത ചുവടുകൾ

സുരക്ഷാ പാസ് കഴിഞ്ഞതിന് ശേഷം.

സുരക്ഷ ഒരിക്കലും പൂർത്തിയാകുന്നില്ല, പക്ഷേ പ്രവർത്തന സ്റ്റാക്കിന്റെ ശേഷി ഒരു ശുദ്ധമായ അടിസ്ഥാനത്തിൽ നിന്ന് പ്രയോജനം നേടുന്നു. യാഥാർത്ഥ്യ ഉപയോഗ ഡാറ്റ സമാഹരിക്കുമ്പോൾ ചെലവിടൽ നിയന്ത്രണങ്ങൾ കർശനമാക്കുക, ലോഡിനെതിരെ വെബ്‌ഹുക്ക് കൈകാര്യം കർശനമാക്കുക, പ്രതിപക്ഷങ്ങൾ നിങ്ങളുടെ പൊതു പ്രൊഫൈലിൽ വിശ്വാസം വയ്ക്കാൻ ഏജന്റിന്റെ തിരിച്ചറിയൽ സ്ഥിരീകരിക്കുക.

പ്രോംപ്റ്റ് ഇഞ്ചക്ഷൻ തരണം ചെയ്യുന്ന ഏജന്റ് ചെലവുകൾ നിയന്ത്രണങ്ങൾ സജ്ജമാക്കുക

8 മിനിറ്റ്

ഡെവലപ്പർമാർ ഏറ്റവും കൂടുതൽ ചോദിക്കുന്ന വെബ്ഹുക്ക് മാതൃകകൾ

15 മിനിറ്റ്

GitHub, ഡൊമെയ്ൻ സ്ഥിരീകരണ ബാഡ്ജുകൾ നേടുക

8 മിനിറ്റ്

മുഴുവൻ റഫറൻസ് docs.blockchain0x.comൽ. ബന്ധപ്പെട്ട ഗ്ലോസറി: Coinbase Smart Wallet. ഉൽപ്പന്ന ഉപരിതലങ്ങൾ: ഏജന്റ് വാലറ്റുകൾ.

അവസാനമായി അവലോകനം ചെയ്തത്: 2026-05-15. CC BY 4.0 പ്രകാരം പ്രസിദ്ധീകരിച്ചു.

വാലറ്റ് കഠിനമായതായി അറിയുന്നുവെന്ന് അയയ്ക്കുക.

പ്രിഫ്ലൈറ്റ് ചെക്ക്‌ലിസ്റ്റ്, റൊട്ടേഷൻ കേഡൻസ്, റൺബുക്ക് പരിശീലനം. തുടങ്ങാൻ സൗജന്യമാണ്.