Skip to main content
POST
/
api
/
local
/
network
/
peers
/
upsert
Local network peers
curl --request POST \
  --url https://api.compose.market/api/local/network/peers/upsert \
  --header 'Content-Type: application/json' \
  --header 'x-session-user-address: <x-session-user-address>' \
  --data '
{
  "userAddress": "<string>",
  "chainId": 123,
  "agentWallet": "<string>",
  "deviceId": "<string>",
  "peers": [
    {}
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.compose.market/llms.txt

Use this file to discover all available pages before exploring further.

Peer records are short-lived. Upsert is rate limited per user and chain.

​
Routes

MethodPathDescription
POST/api/local/network/peers/upsertPublishes current peer summaries.
GET/api/local/network/peersLists current peers for one user and chain.

​
Upsert body

​
userAddress
string
required
Wallet address. Must match x-session-user-address.
​
chainId
number
Chain ID. Defaults to the active chain.
​
agentWallet
string
Optional agent wallet associated with the peers.
​
deviceId
string
Optional local device ID.
​
peers
array
required
Up to 512 peer summaries with peerId, lastSeenAt, stale, caps, and listenMultiaddrs.

​
List query

​
userAddress
string
required
Wallet address. Must match x-session-user-address.
​
chainId
number
Chain ID. Defaults to the active chain.
​
agentWallet
string
Optional agent wallet filter.

​
Headers

​
x-session-user-address
string
required
Must match userAddress.