Skip to content

blockchain.address.get_first_use

blockchain.address.get_first_use

Returns a first occurance of usage of scripthash as ouput on the blockchain.

See blockchain.scripthash.get_first_use.

Signature

Function: blockchain.scripthash.get_first_use(address, { "include_tokens": true, ...})

Version added: Added in Rostrum 1.2 (previously named ElectrsCash)

  • address

    Address encoded as a CashAddr string (with or without prefix). Legacy addresses (base58) are also supported.

  • filter

    Filter dict for what transactions/utxos are included in the result. Valid filters are:

    • from_height - Include from the given block height, inclusive (default: 0).
    • to_height - Include up to the given block height, exclusive. Use -1 to include mempool (default: -1).
    • include_tokens - Include all, including those with tokens (default: true).
    • tokens_only - Include only those that contain tokens (default: false).
    • exclude_tokens - Include only those without tokens (default: false).
    • offset - Skip the first n elements (default: 0)
    • limit - Return at most n elements. Use '0' for no limit (default: 0)

    For backward compatibility, include_tokens, tokens_only, and exclude_tokens can be passed as string instead of dict.

Result

See blockchain.scripthash.get_first_use.