메인 콘텐츠로 건너뛰기

​
개요

지갑 등록은 LaserSell API에 Solana 지갑의 소유권을 증명합니다. Exit Intelligence Stream에 지갑을 연결하기 전에 등록이 필요합니다. 스트림은 configure 메시지의 모든 지갑이 계정에 등록되어 있는지 검증합니다. 등록은 Ed25519 서명을 사용하므로 온체인 트랜잭션이 필요 없습니다.

​
POST /v1/wallets/register

Ed25519 서명으로 소유권을 증명하여 지갑을 등록합니다.

​
요청

{
  "wallet_pubkey": "YourWalletPubkey...",
  "signature": "base58-encoded-ed25519-signature",
  "message": "lasersell-register:YourWalletPubkey...:1706000000",
  "label": "My Trading Wallet"
}
필드타입필수설명
wallet_pubkeystring예등록할 Solana 지갑 공개키.
signaturestring예메시지의 Ed25519 서명, base58 인코딩.
messagestring예구조화된 메시지: lasersell-register:<pubkey>:<unix_timestamp>. 타임스탬프는 5분 이내여야 합니다.
labelstring아니오선택적인 사람이 읽을 수 있는 지갑 레이블.

​
응답

{
  "wallet_pubkey": "YourWalletPubkey...",
  "registered": true
}

​
인증

유효한 API 키가 있는 x-api-key 헤더가 필요합니다.

​
오류

상태코드설명
400Bad Request잘못된 공개키 형식, 잘못된 메시지 형식, 만료된 타임스탬프(5분 초과).
403Forbidden누락되었거나 잘못된 API 키, 서명 검증 실패.

​
DELETE /v1/wallets

지갑 등록을 해제합니다.

​
요청

{
  "wallet_pubkey": "YourWalletPubkey..."
}

​
응답

{
  "wallet_pubkey": "YourWalletPubkey...",
  "removed": true
}

​
SDK 사용법

4개 SDK 모두 지갑 등록을 위한 헬퍼 메서드를 제공합니다.

​
proveOwnership / prove_ownership

키페어를 사용하여 로컬에서 WalletProof를 생성합니다. 네트워크 호출 없는 순수 암호화 작업입니다. 
import { proveOwnership } from "@lasersell/lasersell-sdk";

const proof = proveOwnership(keypair);
// proof = { walletPubkey, signature, message }

​
registerWallet / register_wallet

증명을 API에 전송하여 지갑을 등록합니다. 
const client = ExitApiClient.withApiKey(apiKey);
await client.registerWallet(proof, "My Wallet");

​
connectWithWallets / connect_with_wallets

지갑 등록과 스트림 연결을 한 단계로 수행하는 편의 메서드입니다. 
import { StreamClient, proveOwnership } from "@lasersell/lasersell-sdk";

const proof = proveOwnership(keypair);
const client = new StreamClient(apiKey);
const session = await client.connectWithWallets(
  [proof],
  { target_profit_pct: 50, stop_loss_pct: 10 },
  120, // deadline_timeout_sec
);