Referencia de API para Obtener Billetera

:::warning Reemplazar la URL de ejemplo del node Los ejemplos de esta página usan https://your-node-url como marcador de posición. Se debe reemplazar por la URL del node al que se desea conectar, por ejemplo un node de la red local. :::

Obtener Billetera

Devuelve información sobre una billetera específica en un blockchain determinado, incluyendo su clave pública, dirección, estado y grupos de autorización.

Solicitud

GET /wallets/{address}?blockchainId={blockchainId}

Por ejemplo, si el node está ejecutándose en https://your-node-url, la URL completa es:
https://your-node-url/wallets/{address}?blockchainId={ blockchainId}

Parámetros de ruta y consulta

• address – Dirección de la billetera a buscar.
• blockchainId – ID del blockchain donde existe esta billetera.

Respuesta

La respuesta es un objeto billetera con los siguientes campos:

• publicKey – Clave pública codificada en hexadecimal asociada a la billetera.
• address – Dirección de la billetera (clave de búsqueda para este endpoint).
• parent – Billetera padre, si existe (cadena vacía cuando no se usa).
• enabled – Si esta billetera está actualmente habilitada.
• satelliteWallets – Array de billeteras "satélite" vinculadas (vacío si no hay ninguna).
• authGroups – Objeto que describe los permisos para grupos lógicos, como Wallet con indicadores create/read/update/delete.
• keyType – Tipo de clave utilizada para esta billetera (p. ej. secp256k1).

Ejemplo de respuesta

{

"publicKey": "PUBLIC_KEY_HEX_HERE",
"address": "WALLET_ADDRESS_HERE",
"parent": "",
"enabled": true,
"satelliteWallets": [],
"authGroups": {
"Wallet": {
"create": false,
"read": true,
"update": true,
"delete": false
}
},
"keyType": "secp256k1"
}

cURL

curl -X GET -L https://your-node-url/wallets/{address}?blockchainId={blockchainId} | jq

// Using native fetch (Node 18+)

const nodeUrl = "https://your-node-url";
const address = "<WALLET_ADDRESS>";
const blockchainId = "<BLOCKCHAIN_ID>";

const url = new URL(`${nodeUrl}/wallets/${address}`);
url.searchParams.set("blockchainId", blockchainId);

const res = await fetch(url.toString(), {
headers: { Accept: "application/json" },
});

if (!res.ok) {
throw new Error(`Request failed with status ${res.status}`);
}

const wallet = await res.json();

console.log("Address:", wallet.address);
console.log("Enabled:", wallet.enabled);
console.log("Key type:", wallet.keyType);

import requests

node_url = "https://your-node-url"
address = "<WALLET_ADDRESS>"
blockchain_id = "<BLOCKCHAIN_ID>"

resp = requests.get(
f"{node_url}/wallets/{address}",
params={"blockchainId": blockchain_id},
headers={"Accept": "application/json"},
)
resp.raise_for_status()

wallet = resp.json()

print("Address:", wallet["address"])
print("Enabled:", wallet["enabled"])
print("Key type:", wallet["keyType"])