GET /solana/mcr/{solana_addr}

GET

solana

mcr

{solana_addr}

curl --request GET \
  --url https://mcr.peaq.xyz/solana/mcr/{solana_addr}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcr.peaq.xyz/solana/mcr/{solana_addr}",
  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://mcr.peaq.xyz/solana/mcr/{solana_addr}"

	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://mcr.peaq.xyz/solana/mcr/{solana_addr}")

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

Endpoints

GET /solana/mcr/{solana_addr}
GET /solana/operator/{solana_addr}/machines?offset=0&limit=20

Both endpoints key the existing MCR reads by a Solana address. The server resolves the address through the peaq binding registry on Solana mainnet (program GrsCoPkeLUAoXjuwPfCcuch77Chco1Gx95zCCQNYGqG6, one getAccountInfo read of the reverse-lookup account at finalized commitment) to the bound peaq EVM identity, then serves the same payload as GET /mcr/{did} or GET /operator/{did}/machines. Scoring inputs always come from peaq; Solana is used for identity resolution only. No chain writes. A machine or operator binds its Solana wallet to its peaq address with a dual-signed bind instruction on that program (a permissionless, trustless instruction: no peaq key is involved). The SDK and CLI do not expose the binding write yet; peaq runs it for partner fleets. See Omni-chain: Solana.

Path parameters

string

default:"2hga7WjszaFHAkiUGngLvY16ebtkrKwCeTSGYv9uzK8p"

required

Base58-encoded 32-byte Solana public key.

Query parameters (operator endpoint only)

integer

default:"0"

Zero-based offset into the operator’s machine list.

integer

default:"20"

Page size, 1 to 20.

Response

200 OK: the GET /mcr/{did} payload (or the operator listing) plus two fields:

Field	Type	Description
`solana_address`	string	The requested base58 address
`binding`	object	`evm_addr` (the bound peaq address), `state` (`"active"`), `nonce` (integer)

{
  "did": "did:peaq:0xcc9688aee5c2a9e48897afe46c7b6524383d6f13",
  "machine_id": 445,
  "mcr_score": 0,
  "mcr": "Provisioned",
  "mcr_degraded": false,
  "bond_status": "bonded",
  "negative_flag": false,
  "event_count": 0,
  "revenue_event_count": 0,
  "activity_event_count": 0,
  "revenue_trend": "insufficient",
  "total_revenue": 0,
  "average_revenue_per_event": 0,
  "last_updated": null,
  "solana_address": "2hga7WjszaFHAkiUGngLvY16ebtkrKwCeTSGYv9uzK8p",
  "binding": {
    "evm_addr": "0xcc9688aee5c2a9e48897afe46c7b6524383d6f13",
    "state": "active",
    "nonce": 0
  }
}

An operator with no machines returns an empty machines list, not an error.

Resolution errors

Condition	HTTP	`detail`
Not a valid base58 public key	400	`invalid_address`
No binding record, or a record created but never activated	404	`not_bound`
Binding revoked	410	`binding_revoked`
Resolution budget exhausted	429	`rate_limited`
Solana RPC unreachable or malformed reply	503	`solana_rpc_unavailable`
Binding account malformed	500	`binding_data_invalid`

Once resolution succeeds, every downstream error is the EVM endpoint’s own. Settled outcomes (bound, not_bound, binding_revoked) are cached for 60 seconds, so a just-activated or just-revoked binding can lag by up to one minute.

Examples

curl "https://mcr.peaq.xyz/solana/mcr/2hga7WjszaFHAkiUGngLvY16ebtkrKwCeTSGYv9uzK8p"
curl "https://mcr.peaq.xyz/solana/operator/2hga7WjszaFHAkiUGngLvY16ebtkrKwCeTSGYv9uzK8p/machines?offset=0&limit=20"

These endpoints serve Tokenomics 1.0 machines (address DIDs). The Economics 2.0 MCR server that is rolling out disables the /solana/* routes until it has its own binding resolver. Treat them as 1.0 surface.

⌘I

GET /solana/mcr/{solana_addr}

curl --request GET \
  --url https://mcr.peaq.xyz/solana/mcr/{solana_addr}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcr.peaq.xyz/solana/mcr/{solana_addr}",
  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://mcr.peaq.xyz/solana/mcr/{solana_addr}"

	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://mcr.peaq.xyz/solana/mcr/{solana_addr}")

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

​Endpoints

​Path parameters

​Query parameters (operator endpoint only)

​Response

​Resolution errors

​Examples

Endpoints

Path parameters

Query parameters (operator endpoint only)

Response

Resolution errors

Examples