Catalog PyPI
Back to packageRELEASE DETAILS

0.6.0

PyPI

adp-agent-anchor

Neo3 blockchain anchor for ADP calibration snapshots. Optional extension to adp-agent (Python runtime) that periodically commits signed calibration snapshots to a Neo3-compatible chain.

adpblockchaincalibration-anchorneo3tamper-evidence
Published2 Jun 2026
Direct dependencies3
Transitive dependenciesNot calculated

README

Version 0.6.0 documentation

adp-agent-anchor

PyPI Downloads Python License Spec

Optional Neo3 blockchain anchor for adp-agent (Python runtime). Commits signed calibration snapshots to a Neo3-compatible chain on a schedule for third-party tamper evidence.

pip install adp-agent adp-agent-anchor

Why it's optional

The always-on signed calibration snapshot at /.well-known/adp-calibration.json (ADJ §7.4) is the primary trust mechanism — peers and registries verify against it with one HTTPS fetch plus a signature check, no chain required. The chain anchor is a strictly optional overlay that adds:

  1. Third-party verification without routing through the registry
  2. Evidence that survives agent disappearance — the anchored record stays on-chain even if the agent's HTTPS endpoint goes offline
  3. Anti-rewrite defense — on-chain records are mechanically detectable if an agent later rewrites its journal

Supported targets

All four targets use the same Neo3BlockchainStore client and the same CalibrationStore.cs smart contract — only the RPC URL, contract hash, and signing wallet change.

TargetUse case
mockUnit tests (in-memory, no network)
neo-expressLocal dev chain
neo-customOperator's existing private Neo3 chain
neo-testnetPublic Neo N3 testnet
neo-mainnetPublic Neo N3 mainnet

Usage

from adp_agent import AdpAgentHost
from adp_agent_anchor import BlockchainStoreFactory, CalibrationAnchorScheduler

host = AdpAgentHost(config)

if config.calibration_anchor and config.calibration_anchor.enabled:
    store = BlockchainStoreFactory.create(config.calibration_anchor)
    if store:
        scheduler = CalibrationAnchorScheduler(config, host.journal, store)
        host.after_start(scheduler.start)
        host.before_stop(scheduler.stop)

await host.run()

Status

v0.1.0: Neo3BlockchainStore is stubbed. The interface is defined and MockBlockchainStore + CalibrationAnchorScheduler are fully functional, but the actual Neo3 RPC client wiring is deferred to v0.2.0. Adopters who need Neo3 anchoring today should use the TypeScript runtime's @ai-manifests/adp-agent-anchor package, which has a working implementation built on @cityofzion/neon-js.

License

Apache-2.0 — see LICENSE for the full license text and NOTICE for attribution.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 3

Native requirements
3 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
adp-agent
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
adp-agent~=0.6.0runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pytest>=8.0; extra == "dev"runtime
pytest-asyncio
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pytest-asyncio>=0.24; extra == "dev"runtime

Distribution files

2 collected
adp_agent_anchor-0.6.0-py3-none-any.whl

bdist_wheel · 12.59 KB · Python py3

Source file
adp_agent_anchor-0.6.0.tar.gz

sdist · 12.2 KB · Python source

Source file

Repository

PENDING
ai-manifests/adp-agent-python

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 19:48 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:b04561a7dc0e044beeb0cc23d5fb85a78a2a9ade71278e7641e2e6d630f7e257

Other collected versions

View all collected versions →