xahau.js/packages/xahau/test/client/autofill.test.ts

import { assert } from 'chai'

import { EscrowFinish, Payment, Transaction } from '../../src'
import xahaud from '../fixtures/xahaud'
import {
  setupClient,
  teardownClient,
  type XrplTestContext,
} from '../setupClient'

const NetworkID = 1025
const Fee = '10'
const Sequence = 1432
const LastLedgerSequence = 2908734

describe('client.autofill', function () {
  let testContext: XrplTestContext

  async function setupMockRippledVersionAndID(
    buildVersion: string,
    networkID: number,
  ): Promise<void> {
    await testContext.client.disconnect()
    xahaud.server_info.withNetworkId.result.info.build_version = buildVersion
    xahaud.server_info.withNetworkId.result.info.network_id = networkID
    testContext.client.connection.on('connected', () => {
      testContext.mockRippled?.addResponse(
        'server_info',
        xahaud.server_info.withNetworkId,
      )
    })

    await testContext.client.connect()
  }

  beforeAll(async () => {
    testContext = await setupClient()
  })
  afterAll(async () => teardownClient(testContext))

  it('should not autofill if fields are present', async function () {
    const tx: Transaction = {
      TransactionType: 'DepositPreauth',
      Account: 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf',
      Authorize: 'rpZc4mVfWUif9CRoHRKKcmhu1nx2xktxBo',
      NetworkID,
      Fee,
      Sequence,
      LastLedgerSequence,
    }
    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.NetworkID, NetworkID)
    assert.strictEqual(txResult.Fee, Fee)
    assert.strictEqual(txResult.Sequence, Sequence)
    assert.strictEqual(txResult.LastLedgerSequence, LastLedgerSequence)
  })

  it('ignores network ID if missing', async function () {
    const tx: Payment = {
      TransactionType: 'Payment',
      Account: 'XVLhHMPHU98es4dbozjVtdWzVrDjtV18pX8yuPT7y4xaEHi',
      Amount: '1234',
      Destination: 'X7AcgcsBL6XDcUb289X4mJ8djcdyKaB5hJDWMArnXr61cqZ',
      Fee,
      Sequence,
      LastLedgerSequence,
    }
    testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)

    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.NetworkID, undefined)
  })

  // NetworkID is required in transaction for network > 1024 and from version 1.11.0 or later.
  // More context: https://github.com/XRPLF/xahaud/pull/4370
  it('overrides network ID if > 1024 and version is later than 1.11.0', async function () {
    await setupMockRippledVersionAndID('1.11.1', 1025)
    const tx: Payment = {
      TransactionType: 'Payment',
      Account: 'XVLhHMPHU98es4dbozjVtdWzVrDjtV18pX8yuPT7y4xaEHi',
      Amount: '1234',
      Destination: 'X7AcgcsBL6XDcUb289X4mJ8djcdyKaB5hJDWMArnXr61cqZ',
      Fee,
      Sequence,
      LastLedgerSequence,
    }
    testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)

    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.NetworkID, 1025)
  })

  // NetworkID <= 1024 does not require a newtorkID in transaction.
  // More context: https://github.com/XRPLF/xahaud/pull/4370
  it('ignores network ID if <= 1024', async function () {
    await setupMockRippledVersionAndID('1.11.1', 1023)
    const tx: Payment = {
      TransactionType: 'Payment',
      Account: 'XVLhHMPHU98es4dbozjVtdWzVrDjtV18pX8yuPT7y4xaEHi',
      Amount: '1234',
      Destination: 'X7AcgcsBL6XDcUb289X4mJ8djcdyKaB5hJDWMArnXr61cqZ',
      Fee,
      Sequence,
      LastLedgerSequence,
    }
    testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)

    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.NetworkID, undefined)
  })

  it('converts Account & Destination X-address to their classic address', async function () {
    const tx: Payment = {
      TransactionType: 'Payment',
      Account: 'XVLhHMPHU98es4dbozjVtdWzVrDjtV18pX8yuPT7y4xaEHi',
      Amount: '1234',
      Destination: 'X7AcgcsBL6XDcUb289X4mJ8djcdyKaB5hJDWMArnXr61cqZ',
    }
    testContext.mockRippled!.addResponse(
      'account_info',
      xahaud.account_info.normal,
    )
    testContext.mockRippled!.addResponse('fee', xahaud.fee.feeBase)
    testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)

    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.Account, 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf')
    assert.strictEqual(
      txResult.Destination,
      'r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59',
    )
  })

  it("should autofill Sequence when it's missing", async function () {
    const tx: Transaction = {
      TransactionType: 'DepositPreauth',
      Account: 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf',
      Authorize: 'rpZc4mVfWUif9CRoHRKKcmhu1nx2xktxBo',
      Fee,
      LastLedgerSequence,
    }
    testContext.mockRippled!.addResponse('account_info', {
      status: 'success',
      type: 'response',
      result: {
        account_data: {
          Sequence: 23,
        },
      },
    })
    const txResult = await testContext.client.autofill(tx)

    assert.strictEqual(txResult.Sequence, 23)
  })

  describe('when autofill Fee is missing', function () {
    it('should autofill Fee of a Transaction', async function () {
      const tx: Transaction = {
        TransactionType: 'DepositPreauth',
        Account: 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf',
        Authorize: 'rpZc4mVfWUif9CRoHRKKcmhu1nx2xktxBo',
        Sequence,
        LastLedgerSequence,
      }
      testContext.mockRippled!.addResponse('fee', xahaud.fee.feeBase)
      const txResult = await testContext.client.autofill(tx)

      assert.strictEqual(txResult.Fee, '10')
    })

    it('should autofill Fee of an EscrowFinish transaction', async function () {
      const tx: EscrowFinish = {
        Account: 'rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn',
        TransactionType: 'EscrowFinish',
        Owner: 'rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn',
        OfferSequence: 7,
        Condition:
          'A0258020E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855810100',
        Fulfillment: 'A0028000',
      }
      testContext.mockRippled!.addResponse(
        'account_info',
        xahaud.account_info.normal,
      )
      testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)
      testContext.mockRippled!.addResponse('fee', xahaud.fee.feeFinish)

      const txResult = await testContext.client.autofill(tx)
      assert.strictEqual(txResult.Fee, '330')
    })

    it('should autofill Fee of an EscrowFinish transaction with signersCount', async function () {
      const tx: EscrowFinish = {
        Account: 'rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn',
        TransactionType: 'EscrowFinish',
        Owner: 'rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn',
        OfferSequence: 7,
        Condition:
          'A0258020E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855810100',
        Fulfillment: 'A0028000',
        Sequence,
        LastLedgerSequence,
      }
      testContext.mockRippled!.addResponse(
        'account_info',
        xahaud.account_info.normal,
      )
      testContext.mockRippled!.addResponse('ledger', xahaud.ledger.normal)
      testContext.mockRippled!.addResponse('fee', xahaud.fee.feeFinish)
      const txResult = await testContext.client.autofill(tx, 4)

      assert.strictEqual(txResult.Fee, '380')
    })
  })

  it("should autofill LastLedgerSequence when it's missing", async function () {
    const tx: Transaction = {
      TransactionType: 'DepositPreauth',
      Account: 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf',
      Authorize: 'rpZc4mVfWUif9CRoHRKKcmhu1nx2xktxBo',
      Fee,
      Sequence,
    }
    testContext.mockRippled!.addResponse('ledger', {
      status: 'success',
      type: 'response',
      result: {
        ledger_index: 9038214,
      },
    })
    const txResult = await testContext.client.autofill(tx)
    assert.strictEqual(txResult.LastLedgerSequence, 9038234)
  })

  it('should autofill fields when all are missing', async function () {
    const tx: Transaction = {
      TransactionType: 'DepositPreauth',
      Account: 'rGWrZyQqhTp9Xu7G5Pkayo7bXjH4k4QYpf',
      Authorize: 'rpZc4mVfWUif9CRoHRKKcmhu1nx2xktxBo',
    }
    testContext.mockRippled!.addResponse('account_info', {
      status: 'success',
      type: 'response',
      result: {
        account_data: {
          Sequence: 23,
        },
      },
    })
    testContext.mockRippled!.addResponse('ledger', {
      status: 'success',
      type: 'response',
      result: {
        ledger_index: 9038214,
      },
    })
    testContext.mockRippled!.addResponse('fee', xahaud.fee.feeBase)
    const txResult = await testContext.client.autofill(tx)
    assert.strictEqual(txResult.Fee, '10')
    assert.strictEqual(txResult.Sequence, 23)
    assert.strictEqual(txResult.LastLedgerSequence, 9038234)
  })
})