Перед тем как начать.

• Рабочая интеграция агента от начала до конца на тесте - смотрите добавить-платежи-к-агенту и тестировать-без-настоящих-деньги.
• Контроль расходов настроен - смотрите контроль расходов (это руководство предполагает, что политика уже установлена).
• Менеджер секретов (AWS Secrets Manager, GCP Secret Manager, Vault, 1Password и т.д.) - секретов в .env файлах недостаточно.
• Четко определенный дежурный инженер с административным доступом к панели управления кошельком.
• 15 минут сосредоточенного времени. Чек-лист ниже не является амбициозным - работайте с ним строчка за строчкой.

Запланируйте ротацию ключа API и секрета вебхука.

Квартально - это стандартный ритм; немедленно меняйте на любое из: подозрение на утечку, уход ведущего инженера, инцидент безопасности в другой части компании. Шаблон с двумя ключами позволяет вам менять ключи без простоя: создайте новый ключ, разверните его повсюду, проверьте, затем отозовите старый.

// 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)
}

# 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)

Секреты подписи вебхуков вращаются аналогично через панель управления - включите второй секрет, разверните обработчик для принятия любого из них, затем отключите старый. Оба с квартальной периодичностью с календарными напоминаниями.

Напишите (и отработайте) руководство по инцидентам.

Руководство по действиям полезно только в том случае, если оно было протестировано недавно. Ниже приведен шаблон - скопируйте его в вики вашей команды, отредактируйте под свои специфики и запланируйте 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.

После пропуска безопасности.

Безопасность никогда не заканчивается, но остальная часть операционного стека выигрывает от чистой базы. Ужесточите контроль расходов по мере накопления фактических данных использования, укрепите обработку вебхуков против нагрузки и проверьте идентичность агента, чтобы контрагенты доверяли вашему публичному профилю.

Полная справка на docs.blockchain0x.com. Связанный глоссарий: Coinbase Smart Wallet. Продуктовая поверхность: Кошельки агентов.