Skip to main content

Pure sign + log + anchor library for agent proof

Project description

Nexus Ledger — Signed proof that your agents did the work

Built by Mercury & Vickson of Vickson Enterprises ☿️

Nexus Ledger is a pure sign + log + anchor library.

from nexus_ledger import Agent

agent = Agent("Mercury")
agent.log("delivered_research", {"topic": "market analysis"})
tx = agent.anchor({"task": "research", "result": "complete"})

Core model

  • keypair = identity
  • signature = proof
  • Solana memo anchor = permanent record

No server needed. No registration. No financial features.

Install

pip install nexus-ledger

If that doesn't work:

Problem Fix
command not found: pip Try pip3 install nexus-ledger
Still not found Try python3 -m pip install nexus-ledger
"externally managed environment" Try python3 -m pip install nexus-ledger --user
Still stuck python3 -m venv .venv && source .venv/bin/activate && pip install nexus-ledger

Requirements: Python 3.10+. That's it.

Optional — for on-chain proof anchoring on Solana:

pip install nexus-ledger[solana]

Full example

from nexus_ledger import Agent

agent_a = Agent("Mercury")
agent_b = Agent("Iris")

agent_a.log("delivered_research", {"topic": "market analysis"}, counterparty=agent_b)

tx = agent_a.anchor({"task": "research", "result": "complete"})
assert agent_a.verify({"task": "research", "result": "complete"}, tx["hash"])

print(agent_a.history())

Demo

python demo.py
python demo.py --mainnet
python exchange_demo.py
python cross_machine_demo.py
python relay_demo.py
  • default mode is mock anchoring
  • --mainnet sends real SPL Memo anchors to Solana mainnet-beta

Cross-Machine Usage

from nexus_ledger import Agent

# Machine A
mercury = Agent("Mercury")
mercury.send("delivered_research", {"result": "complete"}, to="Iris")

# Machine B
iris = Agent("Iris")
receipts = iris.check_inbox()

Two machines. Three lines. No configuration.

License

Business Source License 1.1 (BSL 1.1). See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nexus_ledger-2.3.0.tar.gz (12.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nexus_ledger-2.3.0-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file nexus_ledger-2.3.0.tar.gz.

File metadata

  • Download URL: nexus_ledger-2.3.0.tar.gz
  • Upload date:
  • Size: 12.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for nexus_ledger-2.3.0.tar.gz
Algorithm Hash digest
SHA256 cfc02415508b4d07d70db586214be0c19abd0740e160f3f7f9ba6ed5f3565927
MD5 7fef264625cf761fc14fa174d2b72257
BLAKE2b-256 83aa7e2f625fcdea8f9ba4b78dd1c1298f4b79fcb48fd49ce644f120916bc2db

See more details on using hashes here.

File details

Details for the file nexus_ledger-2.3.0-py3-none-any.whl.

File metadata

  • Download URL: nexus_ledger-2.3.0-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for nexus_ledger-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 10e6882b670b574f0c25ed035aeafd413940d5b13beff97055a5c4205f4f6696
MD5 bba972e05c45508554f04160c15c8815
BLAKE2b-256 1243ccdec954ab556b2972a41992f0a7513ad307fd7be12fba1ee09e98f26bb9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page