pip install impp

from impp import Client

client = Client()

# Verify an artifact
result = client.verify("defi-risk-memory.json")
print(result.trust_score)  # 87.3
print(result.certificate)  # Ed25519 signed cert

# Search the registry
artifacts = client.search(domain="defi", min_trust=70)

# Attach to your agent
client.attach("defi-risk-memory.json", agent="my-agent")

result = client.verify("artifact.json")

result.trust_score      # float: 0-100
result.certificate      # dict: Ed25519 certificate
result.probes           # list: individual probe results
result.passed           # bool: all probes passed
result.expires_at       # str: ISO 8601 expiry

result = client.verify(
    "artifact.json",
    pubkey="path/to/registry.pub",  # custom public key
    remote=True,                     # re-check against live registry
    offline=True,                    # use bundled key, no network
)

artifacts = client.search(
    domain="defi",
    min_trust=70,
    q="risk assessment",
    limit=10,
    sort="trust",
)

for a in artifacts:
    print(f"{a.name}@{a.version}: {a.trust_score}")

result = client.publish(
    "my-artifact.json",
    domain="defi",
    description="DeFi risk assessment memory",
    version="v1.0",
)

print(result.artifact_id)   # "defi/my-artifact@v1.0"
print(result.trust_score)   # 87.3
print(result.certificate)   # Ed25519 certificate

client.attach(
    "defi-risk-memory.json",
    agent="my-agent",
    rollback_threshold=5,  # auto-detach after 5 negative transfer events
)

# List attached artifacts
attached = client.list_attached(agent="my-agent")

# Detach
client.detach("defi-risk-memory.json", agent="my-agent")

from impp import Client, VerificationError, PublishError

client = Client()

try:
    result = client.verify("artifact.json")
except VerificationError as e:
    print(f"Verification failed: {e.probe}")  # which probe failed
    print(f"Details: {e.details}")

try:
    client.publish("artifact.json", domain="defi")
except PublishError as e:
    print(f"Publish failed: {e.reason}")

client = Client(
    api_url="https://api.impp.sh/v1",  # default
    token="your-token",                 # or set IMPP_TOKEN env var
    timeout=30,                         # request timeout in seconds
)