Credentials Reference

Credentials involve the following changes to the XRP Ledger protocol.

Ledger entry types

One new type of ledger entry:

• Credential ledger entry - Stores a credential in the ledger

Modifications to the existing type of ledger entry:

• DepositPreauth ledger entry - Records authorization for depositing to a specific account; modified to allow for credential-based authorization.

Transaction Types

Three new transaction types for managing credentials:

• CredentialCreate transaction - Create a credential in the ledger.
• CredentialAccept transaction - Accept a credential issued to you.
• CredentialDelete transaction - Delete a credential from the ledger.

Modifications to an existing transaction type:

• DepositPreauth transaction - Authorizes deposits to your account. Modified to allow credential-based authorization.

A new field for several existing transaction types:

• CredentialIDs field - Credentials to prove authorization to deposit money. Added to Payment, EscrowFinish, PaymentChannelClaim, and AccountDelete transaction types.

API Methods

Extends the following API methods:

• deposit_authorized method - The request can specify a set of credentials to use for authorization. (There are no changes to the response format.)
• ledger_entry method - The request can now look up a Credential entry, or look up a DepositPreauth entry by the preauthorized credentials.

Amendment

This feature requires an amendment to the XRP Ledger.

Introduces credentials for enabling compliance checks and other approvals. Adds new transactions to create, accept, and delete credentials, and a ledger entry type for storing credentials. Modifies DepositPreauth transactions and DepositPreauth ledger entries to allow deposit authorization by credentials instead of individually authorizing each account specifically.