0064 XLS - 64d: Pseudo-Account

[Tapanito]

    
Title:        Pseudo-Account
Revision:     1 (2024-04-12)

  Authors:    
  Vytautas Vito Tumas
  Aanchal Malhotra

Affiliation: 
  Ripple

Pseudo-Account

Abstract

In this document, we propose a standard for a pseudo-account, an AccountRoot object that can be associated with one or more other ledger entries. This feature allows one to link an account with multiple ledger entries to track XRP and Token Balances or issue Fungible Tokens on behalf of the linked ledger entries.

1. Introduction

The XLS-30 specification introduced an AMMID field to the AccountRoot ledger entry. It associates a pseudo-account with an AMM instance to track XRP and Token balances in the pool and issue LPTokens on behalf of the AMM Instance. However, the AMMID DOES NOT allow us to associate the AccountRoot with other ledger entries.

This proposal addresses this limitation by introducing a new LedgerEntries field to the AccountRoot that allows linking the object with one or more other ledger entries. Implementing this specification will deprecate the AMMID.

Furthermore, the proposal introduces minimum requirements for any protocol creating a pseudo-account.

2. Changes to the AccountRoot

The LedgerEntries field links the AccountRoot object with one or more ledger entries.

2.1 New fields

---

Field Name	Required?	JSON Type	Internal Type	Description
LedgerEntries	No	array	Vector256	A list of ledger entry IDs associated with the AccountRoot.

---

3. Creating a pseudo-account

The address of the AccountRoot must be randomized to prevent users from identifying and funding the address before its creation. The protocol that creates an AccountRoot must ensure the account address is unoccupied.

The AccountRoot object for a pseudo-account MUST have the following settings:

• lsfDisableMaster enabled to ensure that no one can control the account directly and send transactions on its behalf.

• lsfDepositAuth enabled to ensure that the only way to add funds to the account is by using a deposit transaction.

The unique ID of the AccountRoot object, a.k.a. AccountRootID is computed as follows:

• for (i = 0; i <= 256; i--)
  • Compute AccountRootID = SHA512-Half(i || Parent Ledger Hash || LedgerEntries[*])
  • If the computed AccountRootID exists, repeat
    • else, return AccountRootID

The list of ledger entries associated with a pseudo-account is modifiable. However, adding or removing object IDs WILL NOT change the AccountRootID.