Skip to content

docs: list TEC-302 helpers in the README inventory - #31

Merged
vvillait88 merged 1 commit into
mainfrom
docs/302k-readme-helpers
May 14, 2026
Merged

docs: list TEC-302 helpers in the README inventory#31
vvillait88 merged 1 commit into
mainfrom
docs/302k-readme-helpers

Conversation

@vvillait88

Copy link
Copy Markdown
Contributor

Summary

Additive update to the README inventory table — documents the helpers that landed in PRs #22#29 + the public-surface guard in #30. Pure docs, no code changes.

What was added

agentscore_commerce.identity (package level) row:

  • load_ucp_signing_key_from_env + LoadUCPSigningKeyOptions (env-driven UCP signing key loader; cached, alg-detected, sanitized errors)
  • hash_operator_token (sha256 hex of plaintext opc_... for merchants persisting operator_token_id to their own DB)

agentscore_commerce.payment row:

  • extract_payment_signer now documents both the positional x402_payment_header path AND the authorization_header= MPP kwarg (did:pkh:eip155 / did:pkh:solana source DIDs)
  • detect_rail_from_headers (returns "x402" / "mpp" / None)
  • classify_orchestration_error (companion to classify_x402_settle_result for orchestration-time exceptions)
  • zero_amount_carve_out (skip CDP/pympp upstream when settle_cents == 0)
  • usd_to_atomic (Decimal-based USD → atomic int, ROUND_HALF_UP)

Test plan

Docs-only; no code changes. Markdown renders cleanly in the existing table.

Additive update to the README inventory: documents the helpers that
landed in PRs #22-#29 + the public-surface guard in #30.

Identity (package level): load_ucp_signing_key_from_env +
LoadUCPSigningKeyOptions (env-driven UCP key loader); hash_operator_token
(sha256 hex of plaintext opc_).

Payment: extract_payment_signer now documents both the positional x402
EIP-3009 path AND the authorization_header= MPP kwarg (did:pkh source
DIDs). New entries: detect_rail_from_headers, classify_orchestration_error,
zero_amount_carve_out, usd_to_atomic.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vvillait88
vvillait88 merged commit 03e87e4 into main May 14, 2026
7 checks passed
@vvillait88
vvillait88 deleted the docs/302k-readme-helpers branch May 14, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant