Skip to content

feat(cardano): allow reading of UTXOs by an address#167

Closed
carbolymer wants to merge 1 commit intoutxorpc:mainfrom
carbolymer:allow-reading-utxos-by-address
Closed

feat(cardano): allow reading of UTXOs by an address#167
carbolymer wants to merge 1 commit intoutxorpc:mainfrom
carbolymer:allow-reading-utxos-by-address

Conversation

@carbolymer
Copy link
Copy Markdown
Contributor

@carbolymer carbolymer commented Sep 5, 2025

In cardano we are able to query UTXOs by TxIn (txoRef in u5c) or by an address. This PR adds capability of querying by addresses to proto definition.

There's also an open question:
What should a server implementation do when an empty list of tx output references or addresses is provided? Should a recommendation for that case be placed in the comments?
It would be convenient to just return a whole UTXO set for that case, which would be very useful for testing.

@carbolymer carbolymer force-pushed the allow-reading-utxos-by-address branch from c6c2657 to efe5773 Compare September 5, 2025 15:12
@carbolymer carbolymer marked this pull request as ready for review September 5, 2025 15:47
@carbolymer carbolymer changed the title feat(cardano): allow reading UTXOs by an address feat(cardano): allow reading of UTXOs by an address Sep 5, 2025
@scarmuega
Copy link
Copy Markdown
Member

@carbolymer the idea of the SearchUtxos call is to solve the needs for querying utxos in a flexible way where complex filters can be specified using different patterns (including addresses).

In contrast, the ReadUtxos call is meant to be a direct way of getting utxos in a key-value fashion, that's why it's constrained to TxoRef (our key in this case).

We decided to split it in this way since there are several optimizations (caching, batch loading, etc) that can be performed only when doing a key-value retrieval.

Do you think that the SearchUtxos method fulfills your requirements? or is there any reason to modify the ReadUtxos call?

@scarmuega scarmuega closed this Oct 13, 2025
@scarmuega
Copy link
Copy Markdown
Member

as discussed in the bi-weekly, the guideline for this use-case is to use the search utxos endpoints.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants