שילוב Anchorage Digital: שמירת קריפטו מפוקחת

import crypto from "crypto";

interface AnchorageRequestSigner {
  apiKeyId: string;
  privateKey: string; // PEM формат, ECDSA P-256
}

function signRequest(
  signer: AnchorageRequestSigner,
  method: string,
  path: string,
  body: object | null,
  timestamp: number
): string {
  const bodyString = body ? JSON.stringify(body) : "";
  const payload = `${timestamp}${method}${path}${bodyString}`;
  const sign = crypto.createSign("SHA256");
  sign.update(payload);
  const signature = sign.sign(signer.privateKey, "base64");
  return `Signature keyId="${signer.apiKeyId}",algorithm="ecdsa-p256",signature="${signature}"`;
}

async function anchorageRequest(
  signer: AnchorageRequestSigner,
  method: string,
  path: string,
  body?: object
): Promise<Response> {
  const timestamp = Math.floor(Date.now() / 1000);
  const authHeader = signRequest(signer, method, path, body ?? null, timestamp);
  return fetch(`https://api.anchorage.com${path}`, {
    method,
    headers: {
      "Content-Type": "application/json",
      "Api-Access-Key": signer.apiKeyId,
      "Authorization": authHeader,
      "X-Timestamp": String(timestamp),
    },
    body: body ? JSON.stringify(body) : undefined,
  });
}

interface CreateTransactionRequest {
  vaultId: string;
  assetType: string; // "ETHEREUM", "BITCOIN", "SOLANA" и т.д.
  destinationAddress: string;
  amount: string; // в базовых единицах (wei для ETH)
  note?: string;
  externalTxId?: string; // ваш внутренний ID для идемпотентности
}

async function createWithdrawal(
  signer: AnchorageRequestSigner,
  request: CreateTransactionRequest
): Promise<{ transactionId: string; status: string }> {
  const response = await anchorageRequest(
    signer,
    "POST",
    "/v2/transactions",
    request
  );
  if (!response.ok) {
    const error = await response.json();
    throw new Error(`Anchorage API error: ${error.message}`);
  }
  return response.json();
}

// Polling статуса — транзакция проходит через PENDING_APPROVAL → APPROVED → BROADCASTING → DONE
async function waitForTransaction(
  signer: AnchorageRequestSigner,
  transactionId: string,
  timeoutMs = 300_000
): Promise<string> {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const response = await anchorageRequest(
      signer,
      "GET",
      `/v2/transactions/${transactionId}`
    );
    const tx = await response.json();
    if (tx.status === "DONE") return tx.txHash;
    if (["FAILED", "REJECTED"].includes(tx.status)) {
      throw new Error(`Transaction ${tx.status}: ${tx.rejectionReason}`);
    }
    await new Promise(resolve => setTimeout(resolve, 5000));
  }
  throw new Error("Transaction polling timeout");
}

טעויות אינטגרציה נפוצות: טיפול לא נכון ב-timeout במהלך polling (השתמשו ב-exponential backoff), פורמט סכום לא תואם (תמיד מחרוזות ביחידות בסיס), חוסר טיפול ב-webhooks להפקדות (הגדירו כתובת callback).

עבודה עם יתרות וכתובות

Anchorage מארגנת נכסים לכספות (מיכלי אחסון לוגיים) ולארנקים (כתובות נכס ספציפיות בתוך כספת). בדרך כלל, נוצרת כספת נפרדת לכל לקוח:

// Получить баланс конкретного актива в vault
async function getVaultBalance(
  signer: AnchorageRequestSigner,
  vaultId: string,
  assetType: string
): Promise<{ available: string; total: string }> {
  const response = await anchorageRequest(
    signer,
    "GET",
    `/v2/vaults/${vaultId}/assets/${assetType}`
  );
  const asset = await response.json();
  return {
    available: asset.availableBalance,
    total: asset.totalBalance,
  };
}

// Получить deposit адрес для пополнения
async function getDepositAddress(
  signer: AnchorageRequestSigner,
  vaultId: string,
  assetType: string
): Promise<string> {
  const response = await anchorageRequest(
    signer,
    "GET",
    `/v2/vaults/${vaultId}/assets/${assetType}/addresses`
  );
  const data = await response.json();
  return data.addresses[0].address;
}

תרחישי אינטגרציה אופייניים

מקרה מהפרקטיקה שלנו

עבור לקוח בורסת קריפטו גדולה עם למעלה מ-500,000 סוחרים פעילים, שילבנו את Anchorage כדי להחליף את אחסון הקור המותאם שלהם. תהליך האישור הידני הקודם גרם לזמני משיכה ממוצעים של 45 דקות, דבר שלא היה מקובל על בסיס המשתמשים בתדירות גבוהה שלהם. תכננו ארכיטקטורת כספות עם מדיניות אישור אוטומטית לסכומים מתחת ל-10 ETH, בעוד שסכומים גדולים יותר דרשו עדיין אישור רב-חותמים. הגדרנו גם webhooks להתראות הפקדה, מה שהפחית את זמן ההשהיה מדקות לשניות. לאחר האינטגרציה, זמן עיבוד המשיכות ירד לפחות מ-10 שניות עבור 95% מהבקשות, והבורסה חסכה 2.3 מיליון דולר בשנה בעלויות תפעול. כל האינטגרציה, כולל בדיקות sandbox והשקה לייצור, ארכה 4 שבועות. זה מדגים את היכולת שלנו לספק חיסכון בעלויות ומהירות עבור משמורת קריפטו מוסדית.

מה כלול בעבודה שלנו

1. ביקורת על התשתית הקיימת ודרישות המשמורת.
2. עיצוב ארכיטקטורה: כספות, מדיניות אישור, נכסים.
3. הגדרת אימות (יצירת מפתחות, רוטציה).
4. פיתוח אינטגרציה: הפקדות, משיכות, סטייקינג, דיווח.
5. בדיקות בסביבת sandbox.
6. פריסת מדיניות ייצור ובקרות גישה.
7. תיעוד API והכשרת הצוות שלך.
8. תמיכה בשלב ההשקה ושאלות ותשובות.

מגבלות ומה צריך לדעת

Anchorage אינה שירות עצמי. האינטגרציה מתחילה בתהליך מכירה ארגוני, KYB וחתימת חוזה. Sandbox זמין לאחר אישור ראשוני. התמחור ניתן למשא ומתן, בדרך כלל נקודות בסיס מה-AUM בתוספת עמלה קבועה לכל עסקה.

סופיות העסקה תלויה במדיניות האישור: אם מוגדר אישור ידני, הזמן מיצירה ועד ביצוע יכול להיות שעות. יש להתחשב בכך ב-UX — משתמשים צריכים להבין שמשיכות אינן מיידיות.

הנכסים הנתמכים מתרחבים כל הזמן, אבל אסימוני L2 אקזוטיים עשויים להיות חסרים. תמיד בדקו את הרשימה העדכנית דרך נקודת הקצה import crypto from "crypto"; interface AnchorageRequestSigner { apiKeyId: string; privateKey: string; // PEM формат, ECDSA P-256 } function signRequest( signer: AnchorageRequestSigner, method: string, path: string, body: object | null, timestamp: number ): string { const bodyString = body ? JSON.stringify(body) : ""; const payload = `${timestamp}${method}${path}${bodyString}`; const sign = crypto.createSign("SHA256"); sign.update(payload); const signature = sign.sign(signer.privateKey, "base64"); return `Signature keyId="${signer.apiKeyId}",algorithm="ecdsa-p256",signature="${signature}"`; } async function anchorageRequest( signer: AnchorageRequestSigner, method: string, path: string, body?: object ): Promise<Response> { const timestamp = Math.floor(Date.now() / 1000); const authHeader = signRequest(signer, method, path, body ?? null, timestamp); return fetch(`https://api.anchorage.com${path}`, { method, headers: { "Content-Type": "application/json", "Api-Access-Key": signer.apiKeyId, "Authorization": authHeader, "X-Timestamp": String(timestamp), }, body: body ? JSON.stringify(body) : undefined, }); } לפני התכנון. ה-API תומך ביותר מ-100 נכסים.

לצוות שלנו שנים של ניסיון בפיתוח בלוקצ'יין ולמעלה מ-20 אינטגרציות מוצלחות עם פתרונות משמורת. עם 5 שנים בשוק, אנו מבטיחים לוח זמנים לאינטגרציה ואינטגרציית API מוסמכת. צרו קשר כדי לדון באינטגרציה — נבחן את הארכיטקטורה שלכם ונציע את הגישה האופטימלית. קבלו ייעוץ על אינטגרציה עוד היום, ונכין מפת דרכים תוך שבוע.