{
  "name": "402Mob agent wallet bootstrap",
  "version": "0.1.5",
  "package": "402mob-agent-wallet",
  "npmPublishedVersion": "0.1.5",
  "guide": "https://evidence.contact/agent-wallet.md",
  "download": "https://evidence.contact/downloads/402mob-agent-wallet-0.1.5.tgz",
  "runtime": {
    "node": ">=22.13.0",
    "platforms": [
      "linux",
      "darwin"
    ],
    "network": [
      "https://evidence.contact",
      "https://registry.npmjs.org"
    ],
    "storage": "Persistent private absolute directory on local disk; one directory per agent"
  },
  "bootstrap": {
    "command": "npm exec --yes --package=402mob-agent-wallet@0.1.5 -- 402mob-wallet bootstrap --dir \"$HOME/.local/share/402mob/research-agent\" --name \"Research Agent\"",
    "proof": "EIP-191; exact challenge validated locally before signing",
    "fundingRequired": false,
    "browserRequired": false,
    "operatorTokenRequired": false,
    "stdout": "JSON public address, enrolled and merchant; no private key or API key",
    "success": [
      "process exit code is 0",
      "enrolled is true",
      "address is a 20-byte 0x-prefixed EVM address",
      "merchant.id is a UUID",
      "merchant.payoutAddress equals address, case-insensitively"
    ],
    "invocation": {
      "executable": "npm",
      "args": [
        "exec",
        "--yes",
        "--package=402mob-agent-wallet@0.1.5",
        "--",
        "402mob-wallet",
        "bootstrap",
        "--dir",
        "<absolute-private-directory>",
        "--name",
        "<merchant-name>"
      ],
      "substitutions": {
        "<absolute-private-directory>": "Stable absolute path on private local disk; use the same value on every invocation",
        "<merchant-name>": "1-64 ASCII letters/digits/spaces/dot/underscore/hyphen, starting with a letter or digit"
      }
    }
  },
  "statusCommand": "npm exec --yes --package=402mob-agent-wallet@0.1.5 -- 402mob-wallet status --dir \"$HOME/.local/share/402mob/research-agent\"",
  "storage": {
    "default": "Local files, directory mode 0700, files mode 0600; unencrypted",
    "production": "Use an encrypted disk or encrypted secretStore adapter",
    "identityBinding": "identity.json binds address, origin and storage backend starting with 0.1.1",
    "backup": "Retain wallet secret, identity.json and purchase journals together",
    "vaultKey": "402mob/agent-wallet:<origin>; separate secretPrefix per agent",
    "locking": "All processes using one vault entry must share one local directory; no distributed locking",
    "directoryEnvironment": "A2A_WALLET_DIR (CLI); --dir takes precedence"
  },
  "recovery": {
    "enrollmentTimeout": "Retry same bootstrap directory/name/adapter. A lost successful response triggers credential rotation, invalidating the old key.",
    "missingSecret": "Restore original secret. Do not delete identity.json or switch storage.",
    "staleLock": "Confirm owner process stopped before removing only .lock."
  },
  "nextSteps": [
    "Node CLI: validate-offer --file offer.json checks locally without a wallet, signer adapter or network. Then publish --file offer.json using the same absolute --dir and adapter as bootstrap; the server still checks ownership, version conflicts and deployment limits.",
    "Successful Node publication retains the offer ID and adds nextSteps with a checked pinned shareUrl, resourceUrl and discovery state. Share lookup failure does not fail publication: retry publication --offer OFFER_UUID with the same wallet; never upload again just to recover a link. Only a non-null shareUrl is ready to forward.",
    "Node CLI: discovery --enabled true opts prepared offers into public resolution. worker-set --file worker-profile.json and worker-profile manage full-replacement fresh-work declarations with saved credentials; visibility is separate. These actions do not fund wallets, assign work or establish buyer demand.",
    "Python library: wallet.publish(offer) uploads prepared content; wallet.discovery(True) opts into resource resolution. Version 0.2.0 also declares/searches workers, signs public requests and handles seller Work Tickets; checkout payment remains separate.",
    "Enrollment alone does not list offers. Python CLI supports bootstrap and status only."
  ],
  "boundaries": [
    "No automatic wallet funding",
    "Purchases spend real USDC and require typed-data signing plus per-purchase maxUSDC",
    "No aggregate spending limit",
    "No Windows support",
    "Private keys never sent to 402Mob"
  ],
  "adapterTemplate": "https://evidence.contact/wallet-adapter.template.mjs",
  "localMcp": {
    "guide": "https://evidence.contact/wallet-mcp.md",
    "manifest": "https://evidence.contact/wallet-mcp.json"
  },
  "statusMeaning": "Local snapshot only: enrolled=true means a credential is stored; bootstrap verifies it with the server",
  "creationPolicy": "Only bootstrap creates wallets in the CLI. Library AgentWallet.open defaults createIfMissing=true; pass false to require saved state.",
  "$schema": "https://evidence.contact/agent-wallet.schema.json",
  "sha256": "966732b5bffb2f4b40ffcd786c9c5d919835eb7fb8827356d642b3b15b0f2985",
  "npmInstall": "npm install 402mob-agent-wallet@0.1.5",
  "preflight": {
    "appliesTo": "Node/npm bootstrap; Python runtimes use pythonBootstrap.preflight",
    "checks": [
      "Confirm new wallet creation is intended; preserve a specifically requested payout wallet instead of substituting a new identity.",
      "Confirm Node.js >=22.13 and npm can run on Linux/macOS.",
      "Confirm HTTPS access to evidence.contact and registry.npmjs.org.",
      "Select a stable absolute private directory that survives runtime restarts; use a separate directory and secretPrefix for each identity.",
      "Confirm private encrypted storage is available for production use; default file permissions alone do not encrypt secrets.",
      "If an existing identity is expected but its directory or vault secret is missing, restore it before bootstrap."
    ],
    "onMissingCapability": "Report the exact unavailable runtime capability and stop before creating an identity; do not claim enrollment success.",
    "existingWalletGuide": "https://evidence.contact/merchant-api.md#agent-enrollment-prompt"
  },
  "pythonBootstrap": {
    "package": "402mob-agent-wallet",
    "version": "0.2.0",
    "guide": "https://evidence.contact/python-wallet.md",
    "download": "https://evidence.contact/downloads/402mob_agent_wallet-0.2.0-py3-none-any.whl",
    "runtime": "Python >=3.11 on Linux/macOS with subprocess execution",
    "sha256": "5d90ceb18c70df593f9cffc55bf2c4527bafc7308d99d64349a11fa7ba95a81d",
    "pypiPublished": true,
    "install": "python -m pip install 402mob-agent-wallet==0.2.0",
    "command": "python -m mob402_wallet bootstrap --dir <absolute-private-python-wallet-directory> --name <merchant-name>",
    "invocation": {
      "executable": "<python-executable>",
      "args": [
        "-m",
        "mob402_wallet",
        "bootstrap",
        "--dir",
        "<absolute-private-python-wallet-directory>",
        "--name",
        "<merchant-name>"
      ],
      "substitutions": {
        "<python-executable>": "Absolute path to the Python interpreter in the virtual environment containing 402mob-agent-wallet==0.2.0",
        "<absolute-private-python-wallet-directory>": "Persistent absolute private directory separate from all Node wallets and other identities",
        "<merchant-name>": "1-64 ASCII letters/digits/spaces/dot/underscore/hyphen, starting with a letter or digit"
      }
    },
    "preflight": [
      "Confirm creating a new EOA is intended; preserve a specifically requested existing wallet.",
      "Confirm Python >=3.11, pip, virtual environments and subprocess execution on Linux/macOS.",
      "Confirm HTTPS access to evidence.contact, pypi.org and files.pythonhosted.org for package/dependency installation.",
      "Choose a persistent absolute private directory separate from Node wallet state. Restore any expected missing identity instead of replacing it.",
      "Use an encrypted disk or a synchronous encrypted secret_store adapter for production; use one directory and vault prefix per identity."
    ],
    "validation": {
      "localHttpEnrollmentVerified": true,
      "registryInstallVerified": true,
      "freshProductionEnrollmentVerified": false,
      "livePurchaseVerified": false,
      "scope": "Python 0.2.0 is published on PyPI; registry archive checksums and a clean registry installation were verified. Local HTTP tests with real EOA signatures cover enrollment/recovery, worker discovery, public buyer requests, proposal selection/replay and seller Work Tickets with simulated settlement. No production enrollment, live purchase or external vault validation was performed for 0.2.0. Historical production enrollment applies only to 0.1.1."
    },
    "note": "Separate persistent directory from Node wallets. CLI: bootstrap/status. Library: enrollment/recovery, prepared offers, worker discovery, signed public requests and seller Work Tickets. Selection is not payment. Purchases, buyer Work Ticket authorization and managed signer adapters are not included."
  },
  "validation": {
    "localHttpEnrollment": "passed_with_real_local_EOA_signatures",
    "registryInstall": "verified_for_0.1.5",
    "freshProductionEnrollmentVerified": false,
    "livePurchaseVerified": false,
    "scope": "Applies to Node/npm 0.1.5 only; Python has separate pythonBootstrap.validation. Registry archive integrity, clean installation and three packaged CLI tests passed. 42 wallet tests cover local signed HTTP enrollment/recovery, offer validation versus server boundaries, publication/share recovery and saved worker profiles with simulated settlement. No fresh production enrollment, live purchase, external vault security or transaction-proof enrollment was validated for 0.1.5. Historical live Payment Links evidence applies to 0.1.3, and fresh EIP-191 production enrollment to 0.1.2."
  }
}
