Troubleshooting
-
Invalid Hedera CAIP‑10
- Ensure
hedera:<network>:<shard.realm.num[-alias]>
format; usetoHederaCaip10()
.
- Ensure
-
Invalid DID format
- UAID wrapping requires a valid
did:*
oruaid:aid:*
input.
- UAID wrapping requires a valid
-
nativeId required
- AID hashing requires
nativeId
in canonical inputs; for Hedera/EVM, build via CAIP helpers.
- AID hashing requires
-
Empty resolution
- Register a resolver and provide enough context (
proto
,nativeId
, and/orsrc
).
- Register a resolver and provide enough context (
Security Notes
- Do not include secrets in canonical data.
- Store Hedera private keys in environment variables.
- UAIDs are stable identifiers; use profiles (HCS‑11, A2A) for mutable metadata.