Lompakot

Lompakko kertoo yhdyskäytävälle, minne kauppa vastaanottaa maksuja yhdessä verkossa pelkkään seurantaan perustuvassa käsittelyssä (watch-only): yhdyskäytävä johtaa jokaiselle maksuaikomukselle uuden osoitteen sinun laajennetusta julkisesta avaimestasi, joten maksut menevät suoraan hallitsemiisi osoitteisiin ja jokainen siirto kohdistuu yksiselitteisesti yhteen aikomukseen.

POST/v1/walletslive · tilin aktivoinnin jälkeen

Pelkkään seurantaan perustuvan lompakon rekisteröinti

Rekisteröi laajennettu julkinen avain (mode: "xpub") verkolle, jonka rekisteri ilmoittaa käytettäväksi ympäristössäsi. Verkko, joka ei ole käytettävissä, torjutaan koodilla network_unavailable.

{
  "store_id": "store_01J…",
  "network_id": "bitcoin:mainnet",
  "label": "Treasury (watch-only)",
  "mode": "xpub",
  "xpub": "zpub…",
  "gap_limit": 20
}

Bitcoin: BIP84-tilin avain (xpub/zpub), joka tuottaa natiiveja SegWit-osoitteita (p2wpkh).
EVM / TRON: tilitason avain (m/44'/60'/0' tai m/44'/195'/0'), joka tuottaa yhden osoitteen aikomusta kohden.

Yksi aktiivinen lompakko kauppaa, verkkoa ja ympäristöä kohden pitää reitityksen deterministisenä. Laajennettu avain salataan tallennettuna, eikä rajapinta koskaan palauta sitä — vastauksissa näkyvät vain sen sormenjälki ja johtamismalli.

Aukkoraja (gap limit)

Lompakko-ohjelmisto lopettaa osoitteiden tarkistamisen tietyn käyttämättömien osoitteiden jakson jälkeen (aukkoraja, täällä oletuksena 20). Jokainen maksuaikomus varaa seuraavan indeksin, joten monet kesken jätetyt kassat voivat ylittää lompakkosi aukkorajan. Lompakko-objektissa ovat kentät next_index, gap_limit ja last_used_index; kun käyttämättömien osoitteiden jakso lähestyy rajaa, saat hälytyksen, jotta voit kasvattaa aukkorajaa lompakko-ohjelmistossasi. Osoitteita ei koskaan käytetä uudelleen eri aikomuksissa.

Omistajuustodisteet

Osoittaaksesi, että hallitset rekisteröityä avainta, allekirjoita haaste johtamisindeksin 0 avaimella:

POST /v1/wallets/{id}/ownership-challenge palauttaa kentät message, address, method (eip191 EVM:lle, bip137 Bitcoinille) ja expires_at.
Allekirjoita message lompakossasi.
POST /v1/wallets/{id}/ownership-proof rungolla { "signature": "…" }.

Käytöstä poistaminen

POST /v1/wallets/{id}/disable lopettaa uusien osoitteiden johtamisen. Asiakkaille jo annettuja osoitteita seurataan, kunnes niiden ikkuna sulkeutuu, joten myöhästyneet maksut havaitaan ja raportoidaan edelleen.