Tree Root

Current Merkle root + leaf count.

curl --request GET \
  --url https://api.darknyx.example.com/tree/root

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/tree/root",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.darknyx.example.com/tree/root"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.darknyx.example.com/tree/root")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "tree_id": 0,
  "merkle_root": "<string>",
  "leaf_count": 123,
  "on_chain_slot": 123
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

A proof is only valid against the root it was built for. Read the root, build the proof, and submit before the tree advances, or the vault rejects the spend with StaleMerkleRoot (6004).

Query Parameters

tree_id

integer

default:0

Which Merkle shard to read (0..num_trees-1). Default 0.

Response

Tree root snapshot.

tree_id

integer

default:0

required

Which Merkle shard this root is for (echoes the request's ?tree_id, default 0). Present under tree-sharding.

merkle_root

string

required

Current Merkle root of shard tree_id, hex-encoded. It should equal finalized on-chain MerkleTree[tree_id].current_root. Historical roots accepted through the on-chain 64-entry history are not returned by this endpoint.

leaf_count

integer

required

Leaf count of this shard.

on_chain_slot

integer

required

Solana slot at which the TEE last synced this shard's mirror from on-chain MerkleTree[tree_id].

⌘I

Current Merkle root + leaf count.

curl --request GET \
  --url https://api.darknyx.example.com/tree/root

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/tree/root",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.darknyx.example.com/tree/root"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.darknyx.example.com/tree/root")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "tree_id": 0,
  "merkle_root": "<string>",
  "leaf_count": 123,
  "on_chain_slot": 123
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

Getting Started

System

Account

Instruments

Orders

Settlement

Tree

WebSocket

Query Parameters

Response