Documentation/canton-network-docsView on canton-network-docs ↗
canton-network-docs

Ledger API Errors

Ledger API Errors - Canton Network Docs
Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.canton.network/llms.txt

Use this file to discover all available pages before exploring further.

These gRPC status codes come from the Ledger API layer.

​
AUTH_INVALID_TOKEN

UNAUTHENTICATED: Could not verify JWT token
Cause: The bearer token is missing, malformed, expired, or signed with an unrecognized key. Fix:
  • Verify the token has not expired (check the exp claim)
  • Confirm the token audience matches LEDGER_API_AUTH_AUDIENCE
  • Ensure the token includes the daml_ledger_api scope
  • Check that the JWKS URL configured on the validator is reachable and returns the correct signing keys

​
PACKAGE_NOT_FOUND

NOT_FOUND: PACKAGE_NOT_FOUND - Could not find package <package-id>
Cause: The validator does not have the DAR that contains the referenced package, or the package has not been vetted. Fix: Upload the DAR: 
dpm build
curl -X POST http://localhost:5002/v2/packages -F "dar=@.build/your-package.dar"
After uploading, confirm the package appears in the package list before retrying the command.

​
PARTY_NOT_KNOWN

NOT_FOUND: PARTY_NOT_KNOWN - Party not known on participant
Cause: The party identifier in the command does not match any party allocated on this validator. Fix: Allocate the party first, or verify you are using the correct party identifier. Party IDs are case-sensitive and include a fingerprint suffix (e.g., Alice::1220abcd...). List known parties: 
curl http://localhost:5002/v2/parties | jq '.party_details[].party'

​
PERMISSION_DENIED

PERMISSION_DENIED: An error occurred. Please contact the operator.
Cause: The authenticated user does not have rights to act as the requested party. Fix: Grant the user read/write access to the party through the Admin API: 
curl -X POST http://localhost:5002/v2/users/<user-id>/rights \
  -H "Content-Type: application/json" \
  -d '{"rights": [{"can_act_as": {"party": "<party-id>"}}]}'
Assistant
Responses are generated using AI and may contain mistakes.