feat: add /rgbpp/v1/address/:address/balance for get bound xUDT balance

[ahonn]

Changes

add /rgbpp/v1/address/:address/balance for get bound xUDT balance

The implementation logic is as follows:

• Retrieve UTXO by btc_address (cacheable).
• Obtain RGB++ assets cell by UTXO (cacheable).
• Fetch all info cell (Unique Cell/Inscription Info Cell) transactions (cacheable, 2 mins by default).
• Filter info cell transactions by the type script of RGB++ assets cell.
• Decode xUDT information (decode from info cell data)
• Aggregate the xUDT token balance based on the same token information.

Response data example:

• Unique Cell as Info Cell

{
  "address": "tb1qtt2vh9q8xam35xxsy35ec6majad8lz8fep8w04",
  "xudt": [
    {
      "name": "XUDT Test Token",
      "decimal": 8,
      "symbol": "XTT",
      "typeHash": "0x10f511f2efb0027191b97ac5b4bd77374ffdac7399e8527d76f5f9bd32e7d35b",
      "amount": "0xa7a3582000"
    },
    {
      "name": "RGBPP Test Token",
      "decimal": 8,
      "symbol": "RTT",
      "typeHash": "0xa9d8fff43320bfaeaf4a6071a1b4432568accd6e7342553eb6fb2d12f10d5a42",
      "amount": "0x775d911905800"
    },
    {
      "name": "RGBPP Test Token",
      "decimal": 8,
      "symbol": "RTT",
      "typeHash": "0x9b1e817fc57b12afd068d37687068d80b0d64593b0f87607dd4db667a9d4a49a",
      "amount": "0x775ee05fb5c00"
    }
  ]
}

• Inscription Info Cell as Info Cell

{
  "address": "tb1qn3my2r0g95wwzf4n4yyyva6mvre5xcc6l72uzk",
  "xudt": [
    {
      "name": "ZooCoin",
      "decimal": 18,
      "symbol": "Zoo",
      "amount": "0xde0b6b3a7640000",
      "typeHash": "0xae9d5b93b0e457eabf8a13626b326e2e4cf75410b2ef5b8348d06d53c0e172c7"
    },
    {
      "name": "CKB Fist Inscription",
      "decimal": 8,
      "symbol": "CKBI",
      "amount": "0xf3d7f1c906",
      "typeHash": "0x7337d2075479d5c6789564516be1db11478e1d3ca70ad88050fe0bf3ff05acc2"
    }
  ]
}

• Inscription Info Cell as Info Cell (rebased)

{
  "address": "tb1qxxz8nmffa4d5ppzvazm06pla6rjje93dgx3tq8",
  "xudt": [
    {
      "name": "MemesCoin",
      "decimal": 8,
      "symbol": "MEMES",
      "amount": "0x104c533c000",
      "typeHash": "0x92a76e4d65034c586fecab43b8ba8529bfa4f3150a7f7b08062dae4d0c02951e"
    }
  ]
}

References

• https://omiga-core.notion.site/Omiga-Inscritption-885f9073c1a6499db08f5815b7de20d7

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
btc-assets-api	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	May 28, 2024 2:06am

[Flouse]

The symbol of https://pudge.explorer.nervos.org/xudt/0x10f511f2efb0027191b97ac5b4bd77374ffdac7399e8527d76f5f9bd32e7d35b is PDD, not XTT.
It might be a bug of Explorer.

Reason

The token owner has issued PDD in a previous tx https://pudge.explorer.nervos.org/transaction/0x6a35da16ab1198008545c78b91abe22999f0dc823055553a13d7de29f3063111

I think we can ignore this situation for now.

[Flouse]

Will you add the unconfirmed balance/amount data type in this PR or another PR?

[ahonn]

Will you add the unconfirmed balance/amount data type in this PR or another PR?

Yes, I will open a PR for that

[Flouse]

It might be better to change the test case to PDD: https://pudge.explorer.nervos.org/transaction/0x6a35da16ab1198008545c78b91abe22999f0dc823055553a13d7de29f3063111

context: #146 (comment)