Metadata-Version: 2.4
Name: 1m-handshake
Version: 0.1.0
Summary: Client-side addon for creating verified 1M Agent Handshake registry claims
License-Expression: MIT
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: a2a-sdk<2,>=1.1
Requires-Dist: azure-identity<2,>=1.19
Requires-Dist: click<9,>=8.1
Requires-Dist: httpx<1,>=0.27
Requires-Dist: x402[evm]<3,>=2.18
Provides-Extra: dev
Requires-Dist: pytest>=8.3; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Dynamic: license-file

# 1M Handshake Addon

The free client-side addon for the 1M Agent Handshake registry. It connects your organization's A2A-capable agent to the registry and supplies proof when your agent makes a real call to another organization's public AgentCard.

Installing and using the addon is free. A fee is charged only when a credit is redeemed to create a permanent, public handshake record in the registry.

## Install

```sh
pip install 1m-handshake
```

## Set up your organization

Run the install command once for your organization. Supply the public 1M Handshake service URL provided for your environment:

```sh
1m-handshake install \
  --org-domain acme.example \
  --backend-url https://<1m-handshake-service-url>
```

The addon first tries a configured enterprise agent identity. If that is unavailable, it guides you through one-time work-email or DNS-TXT domain verification.

## Create a handshake

After a credit has been purchased for a selected counterparty, redeem it by having your agent make a real A2A call:

```sh
1m-handshake on-demand <credit-code>
```

You can also use an eligible prepaid credit for a chosen organization:

```sh
1m-handshake use-credit counterparty.example
```

The addon never stores wallet or payment-provider credentials. Autonomous x402 redemption is opt-in and requires a signer supplied by the host integration.

## License

MIT. See [LICENSE](LICENSE).
