Honeycluster Docs – One-shot path finding

Path Finding Methods

One-shot path finding

wss://honeycluster.io

rpc method: ripple_path_find

Finds payment paths for a one-time lookup (no streaming updates). Works over both HTTP and WebSocket.

Try it now

Response · ripple_path_find WS Response

{
  "result": {
    "alternatives": [
      {
        "paths_computed": [
          [
            {
              "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
              "type": 1
            }
          ]
        ],
        "source_amount": "207414"
      }
    ],
    "destination_account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "destination_currencies": [
      "USD",
      "XRP"
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request Message

ripple_path_find WS Request

application/json

One-shot path finding

Field	Type	Description
`command` required	string	WebSocket command name
`id`	object	Client-supplied identifier to correlate requests with responses.
`source_account`	string	The account that would send the payment.
`destination_account`	string	The account that would receive the payment.
`destination_amount`	object	The amount the destination would receive. Can be a string (XRP drops) or currency object.
`send_max`	object	Maximum amount the source is willing to send.
`source_currencies`	object[]	Array of currencies the source can use.
`source_currencies[].currency` required	string	Three-letter ISO 4217 currency code, or 160-bit hex currency code.
`source_currencies[].issuer`	string	Account address of the token issuer. Omit for XRP.
`ledger_index`	object	A ledger index (sequence number) or shortcut string identifying which ledger to use.
`ledger_hash`	string	256-bit hex hash identifying a specific ledger version.
`api_version`	object	API version for the response format. Version 2 is the default for rippled 2.0+.

Example

Json

{
  "command": "ripple_path_find",
  "id": 1,
  "source_account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
  "destination_account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
  "destination_amount": {
    "currency": "USD",
    "issuer": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "value": "100"
  },
  "source_currencies": [
    {
      "currency": "XRP"
    }
  ]
}

Response Message

ripple_path_find WS Response

application/json

WebSocket response for ripple_path_find

Field	Type	Description
`result`	object
`status`	enum<string>	Available `successerror`
`type`	string
`id`	stringnumber	Echo of the client-provided correlation ID

Example

Json

{
  "result": {
    "alternatives": [
      {
        "paths_computed": [
          [
            {
              "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
              "type": 1
            }
          ]
        ],
        "source_amount": "207414"
      }
    ],
    "destination_account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "destination_currencies": [
      "USD",
      "XRP"
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request

Payload · JSON

const ws = new WebSocket('wss://honeycluster.io');

ws.addEventListener('open', () => {
  const request = {
    "command": "ripple_path_find",
    "id": 1,
    "source_account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
    "destination_account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "destination_amount": {
      "currency": "USD",
      "issuer": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
      "value": "100"
    },
    "source_currencies": [
      {
        "currency": "XRP"
      }
    ]
  };
  ws.send(JSON.stringify(request));
});

ws.addEventListener('message', (event: MessageEvent<string>) => {
  const response: unknown = JSON.parse(event.data);
  console.log(response);
  ws.close();
});

Response · ripple_path_find WS Response

{
  "result": {
    "alternatives": [
      {
        "paths_computed": [
          [
            {
              "account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
              "type": 1
            }
          ]
        ],
        "source_amount": "207414"
      }
    ],
    "destination_account": "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",
    "destination_currencies": [
      "USD",
      "XRP"
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}