@hightop/sdk 0.1.4 → 0.1.6

package/README.md

@@ -43,6 +43,7 @@ const client = new HightopAgentClient({
 })
 
 const self = await client.self.get()
+const collateralOptions = await client.request('GET /v1/agent/borrow/collateral-options')
 const repay = await client.borrow.repay(
   { asset: 'GREEN', amount_usd: '10' },
   { idempotencyKey: createIdempotencyKey() },
@@ -62,6 +63,11 @@ const capabilities = await new HightopAgentClient({ baseUrl: 'https://api.highto
 Every catalogued `/v1/agent/*` endpoint is available through the generated typed request map:
 
 ```ts
+const collateralOptions = await client.request('GET /v1/agent/borrow/collateral-options')
+const usdcVault = collateralOptions.items.find(
+  (option) => option.source_type === 'earn_vault' && option.asset_symbol === 'USDC',
+)
+
 const oneOff = await client.request(
   'POST /v1/agent/one-off-payments',
   {
@@ -75,6 +81,8 @@ const oneOff = await client.request(
 )
 ```
 
+For `POST /v1/agent/borrow/collateral/add`, pass a collateral option `id` as `asset`. Vault-backed options use a vault contract address as the id, so callers should discover options instead of guessing from token symbols.
+
 The generated package artifact exports:
 
 ```ts

package/dist/client.js

@@ -230,6 +230,7 @@ export class HightopAgentClient {
         while (Date.now() <= deadline) {
             const remainingMs = Math.max(1, deadline - Date.now());
             const pollRequestTimeoutMs = Math.min(this.timeoutMs, remainingMs);
+            const pollBoundByWaitDeadline = pollRequestTimeoutMs === remainingMs;
             let response;
             try {
                 response = await this.operations.get(id, undefined, {
@@ -239,7 +240,9 @@ export class HightopAgentClient {
                 });
             }
             catch (error) {
-                if (Date.now() >= deadline && error instanceof HightopAgentSDKError && error.code === 'request_timeout') {
+                if (error instanceof HightopAgentSDKError &&
+                    error.code === 'request_timeout' &&
+                    (pollBoundByWaitDeadline || Date.now() >= deadline)) {
                     break;
                 }
                 throw error;

package/dist/generated/agent-api.d.ts

@@ -1,4 +1,4 @@
-export declare const AGENT_API_CONTRACT_VERSION = "1.6.0";
+export declare const AGENT_API_CONTRACT_VERSION = "1.7.0";
 export type EthAddress = `0x${string}`;
 export type AgentErrorDetailsByCode = {
     idempotency_request_in_progress: {
@@ -34,6 +34,12 @@ export type AgentErrorDetailsByCode = {
         period: 'rolling_30d' | 'active';
     } | {
         max_endpoints: number;
+    } | {
+        cap: number;
+        observed: number;
+        period: 'manager_period';
+        cap_kind: 'max_num_swaps_per_period';
+        quote_id: string;
     };
     ltv_too_high: {
         current_ltv: string;
@@ -115,6 +121,32 @@ export type AgentApiSelfUsageResponse = {
         operations_submitted_today?: number;
     };
 };
+export type AgentApiSelfLimitsResponse = {
+    ok: true;
+    spend_limits: {
+        per_tx_usd: string | null;
+        per_period_usd: string | null;
+        lifetime_usd: string | null;
+        max_txs_per_period: number | null;
+        tx_cooldown_blocks: number | null;
+        fail_on_zero_price: boolean;
+    };
+    swap_limits: {
+        max_slippage_bps: number | null;
+        max_swaps_per_period: number | null;
+    };
+    permissions: {
+        operation_types: Array<'payment' | 'conversion' | 'earn.deposit' | 'earn.withdraw' | 'earn.move' | 'earn.rewards_claim' | 'debt.borrow' | 'debt.repay' | 'debt.deleverage' | 'collateral.add' | 'collateral.remove' | 'trusted_destination.confirm' | 'trusted_destination.cancel' | 'trusted_destination.remove' | 'withdrawal.bank' | 'withdrawal.crypto' | 'one_off_payment.create'>;
+        cannot: Array<'payment' | 'conversion' | 'earn.deposit' | 'earn.withdraw' | 'earn.move' | 'earn.rewards_claim' | 'debt.borrow' | 'debt.repay' | 'debt.deleverage' | 'collateral.add' | 'collateral.remove' | 'trusted_destination.confirm' | 'trusted_destination.cancel' | 'trusted_destination.remove' | 'withdrawal.bank' | 'withdrawal.crypto' | 'one_off_payment.create'>;
+    };
+    current_usage: {
+        txs_in_period: number;
+        spent_in_period_usd: string;
+        swaps_in_period: number;
+        total_txs: number;
+        total_spent_usd: string;
+    };
+};
 export type AgentApiCapabilitiesResponse = {
     ok: true;
     api_version: '1.0';
@@ -592,6 +624,30 @@ export type AgentApiCollateralResponse = {
     next_cursor: string | null;
     has_more: boolean;
 };
+export type AgentApiCollateralOptionsResponse = {
+    ok: true;
+    items: Array<{
+        id: string;
+        asset_symbol: string;
+        asset_display_name: string;
+        asset_address: string;
+        source_type: 'cash' | 'earn_vault';
+        vault_id?: string;
+        vault_name?: string;
+        protocol_id?: string;
+        protocol_name?: string;
+        amount: string;
+        amount_usd: string;
+        ltv: string;
+        max_ltv: string;
+        borrow_power_usd: string;
+        increases_borrow_capacity: boolean;
+        apy?: string;
+        allowed: true;
+    }>;
+    next_cursor: string | null;
+    has_more: boolean;
+};
 export type AgentApiBorrowRepayRequest = {
     asset: 'GREEN' | '0xd1Eac76497D06Cf15475A5e3984D5bC03de7C707';
     repay_all?: boolean;
@@ -668,6 +724,7 @@ export type AgentApiSimulateRequest = {
     method: 'POST' | 'PATCH' | 'DELETE';
     path: string;
     body: unknown;
+    depth?: 'static' | 'policy' | 'onchain';
 };
 export type AgentApiSimulateResponse = {
     ok: true;
@@ -1014,6 +1071,21 @@ export declare const agentApiEndpoints: readonly [{
     readonly idempotencyRequired: false;
     readonly routeClass: "read";
     readonly description: "Return current Agent API rate-limit and usage state.";
+}, {
+    readonly key: "GET /v1/agent/self/limits";
+    readonly method: "GET";
+    readonly path: "/v1/agent/self/limits";
+    readonly pathParams: readonly [];
+    readonly queryParams: readonly [];
+    readonly bodyParams: readonly [];
+    readonly requestSchema: null;
+    readonly bodySchema: null;
+    readonly responseSchema: "agentApiSelfLimitsResponse";
+    readonly requestType: null;
+    readonly responseType: "AgentApiSelfLimitsResponse";
+    readonly idempotencyRequired: false;
+    readonly routeClass: "read";
+    readonly description: "Return the authenticated agent's configured spend limits and current-period usage.";
 }, {
     readonly key: "GET /v1/agent/capabilities";
     readonly method: "GET";
@@ -1554,6 +1626,21 @@ export declare const agentApiEndpoints: readonly [{
     readonly idempotencyRequired: false;
     readonly routeClass: "read";
     readonly description: "List collateral for the authenticated agent wallet.";
+}, {
+    readonly key: "GET /v1/agent/borrow/collateral-options";
+    readonly method: "GET";
+    readonly path: "/v1/agent/borrow/collateral-options";
+    readonly pathParams: readonly [];
+    readonly queryParams: readonly ["cursor", "limit"];
+    readonly bodyParams: readonly [];
+    readonly requestSchema: "agentApiResourceListQuery";
+    readonly bodySchema: null;
+    readonly responseSchema: "agentApiCollateralOptionsResponse";
+    readonly requestType: "AgentApiResourceListQuery";
+    readonly responseType: "AgentApiCollateralOptionsResponse";
+    readonly idempotencyRequired: false;
+    readonly routeClass: "read";
+    readonly description: "List addable collateral options for the authenticated agent wallet.";
 }, {
     readonly key: "POST /v1/agent/borrow/repay";
     readonly method: "POST";
@@ -1785,7 +1872,7 @@ export declare const agentApiEndpoints: readonly [{
     readonly path: "/v1/agent/simulate";
     readonly pathParams: readonly [];
     readonly queryParams: readonly [];
-    readonly bodyParams: readonly ["method", "path", "body"];
+    readonly bodyParams: readonly ["method", "path", "body", "depth"];
     readonly requestSchema: "agentApiSimulateRequest";
     readonly bodySchema: "agentApiSimulateRequest";
     readonly responseSchema: "agentApiSimulateResponse";
@@ -1968,6 +2055,7 @@ export type AgentApiPathParams = Record<string, AgentApiPathParamValue>;
 export type AgentApiEndpointRequestMap = {
     readonly 'GET /v1/agent/self': undefined;
     readonly 'GET /v1/agent/self/usage': undefined;
+    readonly 'GET /v1/agent/self/limits': undefined;
     readonly 'GET /v1/agent/capabilities': undefined;
     readonly 'GET /v1/agent/capabilities.json': undefined;
     readonly 'GET /v1/agent/account': undefined;
@@ -2016,6 +2104,7 @@ export type AgentApiEndpointRequestMap = {
     readonly 'GET /v1/agent/borrow': undefined;
     readonly 'POST /v1/agent/borrow': AgentApiBorrowRequest;
     readonly 'GET /v1/agent/borrow/collateral': AgentApiResourceListQuery;
+    readonly 'GET /v1/agent/borrow/collateral-options': AgentApiResourceListQuery;
     readonly 'POST /v1/agent/borrow/repay': AgentApiBorrowRepayRequest;
     readonly 'POST /v1/agent/borrow/deleverage': AgentApiDeleverageRequest;
     readonly 'POST /v1/agent/borrow/collateral/add': AgentApiCollateralAddRequest;
@@ -2071,6 +2160,7 @@ export type AgentApiEndpointRequestMap = {
 export type AgentApiEndpointResponseMap = {
     readonly 'GET /v1/agent/self': AgentApiSelfResponse;
     readonly 'GET /v1/agent/self/usage': AgentApiSelfUsageResponse;
+    readonly 'GET /v1/agent/self/limits': AgentApiSelfLimitsResponse;
     readonly 'GET /v1/agent/capabilities': AgentApiCapabilitiesResponse;
     readonly 'GET /v1/agent/capabilities.json': AgentApiCapabilitiesResponse;
     readonly 'GET /v1/agent/account': AgentApiAccountResponse;
@@ -2107,6 +2197,7 @@ export type AgentApiEndpointResponseMap = {
     readonly 'GET /v1/agent/borrow': AgentApiBorrowResponse;
     readonly 'POST /v1/agent/borrow': AgentApiWriteResponse;
     readonly 'GET /v1/agent/borrow/collateral': AgentApiCollateralResponse;
+    readonly 'GET /v1/agent/borrow/collateral-options': AgentApiCollateralOptionsResponse;
     readonly 'POST /v1/agent/borrow/repay': AgentApiWriteResponse;
     readonly 'POST /v1/agent/borrow/deleverage': AgentApiWriteResponse;
     readonly 'POST /v1/agent/borrow/collateral/add': AgentApiWriteResponse;

package/dist/generated/agent-api.js

@@ -3,7 +3,7 @@
 // Generated by scripts/generateAgentPackageSdk.ts
 // ═══════════════════════════════════════════════════════════════════════════
 /* eslint-disable */
-export const AGENT_API_CONTRACT_VERSION = '1.6.0';
+export const AGENT_API_CONTRACT_VERSION = '1.7.0';
 function isAgentSdkRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -30,7 +30,13 @@ export const agentErrorDetailsValidators = {
         typeof value['cap'] === 'number' &&
         typeof value['observed'] === 'number' &&
         ['rolling_30d', 'active'].includes(value['period'])) ||
-        (isAgentSdkRecord(value) && typeof value['max_endpoints'] === 'number'),
+        (isAgentSdkRecord(value) && typeof value['max_endpoints'] === 'number') ||
+        (isAgentSdkRecord(value) &&
+            typeof value['cap'] === 'number' &&
+            typeof value['observed'] === 'number' &&
+            ['manager_period'].includes(value['period']) &&
+            ['max_num_swaps_per_period'].includes(value['cap_kind']) &&
+            typeof value['quote_id'] === 'string'),
     ltv_too_high: (value) => isAgentSdkRecord(value) &&
         typeof value['current_ltv'] === 'string' &&
         typeof value['estimated_ltv_after'] === 'string' &&
@@ -129,6 +135,22 @@ export const agentApiEndpoints = [
         routeClass: 'read',
         description: 'Return current Agent API rate-limit and usage state.',
     },
+    {
+        key: 'GET /v1/agent/self/limits',
+        method: 'GET',
+        path: '/v1/agent/self/limits',
+        pathParams: [],
+        queryParams: [],
+        bodyParams: [],
+        requestSchema: null,
+        bodySchema: null,
+        responseSchema: 'agentApiSelfLimitsResponse',
+        requestType: null,
+        responseType: 'AgentApiSelfLimitsResponse',
+        idempotencyRequired: false,
+        routeClass: 'read',
+        description: "Return the authenticated agent's configured spend limits and current-period usage.",
+    },
     {
         key: 'GET /v1/agent/capabilities',
         method: 'GET',
@@ -705,6 +727,22 @@ export const agentApiEndpoints = [
         routeClass: 'read',
         description: 'List collateral for the authenticated agent wallet.',
     },
+    {
+        key: 'GET /v1/agent/borrow/collateral-options',
+        method: 'GET',
+        path: '/v1/agent/borrow/collateral-options',
+        pathParams: [],
+        queryParams: ['cursor', 'limit'],
+        bodyParams: [],
+        requestSchema: 'agentApiResourceListQuery',
+        bodySchema: null,
+        responseSchema: 'agentApiCollateralOptionsResponse',
+        requestType: 'AgentApiResourceListQuery',
+        responseType: 'AgentApiCollateralOptionsResponse',
+        idempotencyRequired: false,
+        routeClass: 'read',
+        description: 'List addable collateral options for the authenticated agent wallet.',
+    },
     {
         key: 'POST /v1/agent/borrow/repay',
         method: 'POST',
@@ -966,7 +1004,7 @@ export const agentApiEndpoints = [
         path: '/v1/agent/simulate',
         pathParams: [],
         queryParams: [],
-        bodyParams: ['method', 'path', 'body'],
+        bodyParams: ['method', 'path', 'body', 'depth'],
         requestSchema: 'agentApiSimulateRequest',
         bodySchema: 'agentApiSimulateRequest',
         responseSchema: 'agentApiSimulateResponse',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hightop/sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",