resolveExtendedAddress

Finalized

Introduction

The resolveExtendedAddress method queries the node's CoreStreamProcessor to resolve the final routing instructions for an Extended Address before making a transaction. This might involve P2P communication if the address requires dynamic resolution.


Request

Requests can be made using either HTTP POST with a JSON body or HTTP GET with URL query parameters.

Parameters

NameTypeRequiredDescription
extendedAddressstringYesThe base58-encoded extended address to resolve.
amountstringNoThe intended IxiNumber amount for the transaction. Defaults to 0.

Example POST Request

POST /resolveExtendedAddress
Content-Type: application/json

{
  "method": "resolveExtendedAddress",
  "params": {
    "extendedAddress": "1EXSqPpj49ZmKiWF8stsMsMXVnSfkee7EzTaBakwNn9sJdaWm...",
    "amount": "10.0"
  },
  "id": 1
}

Example GET Request

GET /resolveExtendedAddress?extendedAddress=1EXSqPpj49Zm...&amount=10.0

Response

The response is a confirmation containing the resolved Extended Address.

Result Structure

FieldTypeDescription
resultstringThe string representation of the resolved Extended Address.

Example Success Response

{
  "result": "1EXSqPpj49ZmKiWF8stsMsMXVnSfkee7EzTaBakwNn9sJdaWm...",
  "id": 1,
  "error": null
}

Example Error Response

This error is returned if the extended address string cannot be parsed.

{
    "result": null,
    "id": 1,
    "error": {
        "code": -32602,
        "message": "extendedAddress parameter is invalid: ..."
    }
}

Behavioral Notes

  • Asynchronous Processing: This endpoint awaits the CoreStreamProcessor, which might require establishing stream connections and querying other nodes. The request may take some time to complete depending on network conditions.