@gpuai/sdk 0.2.5 → 0.3.1

package/docs/BillingApi.md

@@ -4,11 +4,165 @@ All URIs are relative to *https://api.gpu.ai/v1*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
+| [**createCryptoDeposit**](BillingApi.md#createcryptodepositoperation) | **POST** /billing/deposits/crypto | Create a stablecoin deposit |
+| [**getDeposit**](BillingApi.md#getdeposit) | **GET** /billing/deposits/{id} | Get one stablecoin deposit |
 | [**getSpendingLimit**](BillingApi.md#getspendinglimit) | **GET** /billing/spending-limit | Get the org spending limit |
+| [**listDeposits**](BillingApi.md#listdeposits) | **GET** /billing/deposits | List stablecoin deposits |
 | [**updateSpendingLimit**](BillingApi.md#updatespendinglimitoperation) | **PUT** /billing/spending-limit | Set the org spending limit |
 
 
 
+## createCryptoDeposit
+
+> CryptoDeposit createCryptoDeposit(createCryptoDepositRequest)
+
+Create a stablecoin deposit
+
+Creates a deposit intent and returns the payment address and the exact token amount to send. Requires the `billing:write` scope; any member of the organization may add funds. Send the exact `pay_amount` of `asset` on `chain` and no other network — funds sent on a different network are not detected automatically. Returns 404 when stablecoin deposits are not enabled for this deployment. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from '@gpuai/sdk';
+import type { CreateCryptoDepositOperationRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // CreateCryptoDepositRequest
+    createCryptoDepositRequest: ...,
+  } satisfies CreateCryptoDepositOperationRequest;
+
+  try {
+    const data = await api.createCryptoDeposit(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createCryptoDepositRequest** | [CreateCryptoDepositRequest](CreateCryptoDepositRequest.md) |  | |
+
+### Return type
+
+[**CryptoDeposit**](CryptoDeposit.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Created |  -  |
+| **400** | `validation-error` — `amount_cents` is below the configured minimum. `unsupported-chain-asset` — the chain/asset pair is not available. `invalid-request` — malformed JSON body.  |  -  |
+| **403** | `org-frozen` — the organization cannot add funds; contact support. |  -  |
+| **404** | Error response (RFC 7807) |  -  |
+| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
+| **503** | &#x60;payment-source-unavailable&#x60; — deposits are temporarily unavailable; retry shortly. |  -  |
+| **0** | Error response (RFC 7807) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getDeposit
+
+> CryptoDeposit getDeposit(id)
+
+Get one stablecoin deposit
+
+Returns a single deposit belonging to the caller\&#39;s organization. Requires the &#x60;billing:read&#x60; scope. A deposit belonging to another organization returns the same &#x60;404 deposit-not-found&#x60; as one that does not exist — deliberately, so this endpoint cannot be used to test whether a deposit id is real. Also 404 when stablecoin deposits are not enabled for this deployment. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from '@gpuai/sdk';
+import type { GetDepositRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string | The deposit id.
+    id: id_example,
+  } satisfies GetDepositRequest;
+
+  try {
+    const data = await api.getDeposit(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` | The deposit id. | [Defaults to `undefined`] |
+
+### Return type
+
+[**CryptoDeposit**](CryptoDeposit.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OK |  -  |
+| **404** | &#x60;deposit-not-found&#x60; — no such deposit, or it belongs to another organization. &#x60;not-found&#x60; — the feature is not enabled.  |  -  |
+| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
+| **0** | Error response (RFC 7807) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getSpendingLimit
 
 > SpendingLimit getSpendingLimit()
@@ -75,6 +229,72 @@ This endpoint does not need any parameter.
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## listDeposits
+
+> ListDeposits200Response listDeposits()
+
+List stablecoin deposits
+
+Returns the organization\&#39;s stablecoin deposits, newest first, capped at 50. Requires the &#x60;billing:read&#x60; scope. The organization is taken from the authenticated API key, never from a parameter. Returns 404 when stablecoin deposits are not enabled for this deployment. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from '@gpuai/sdk';
+import type { ListDepositsRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  try {
+    const data = await api.listDeposits();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**ListDeposits200Response**](ListDeposits200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`, `application/problem+json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OK |  -  |
+| **404** | Error response (RFC 7807) |  -  |
+| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
+| **0** | Error response (RFC 7807) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## updateSpendingLimit
 
 > SpendingLimit updateSpendingLimit(updateSpendingLimitRequest)

package/docs/CommunityApi.md

@@ -6,13 +6,10 @@ All URIs are relative to *https://api.gpu.ai/v1*
 |------------- | ------------- | -------------|
 | [**delistCommunityMachine**](CommunityApi.md#delistcommunitymachine) | **POST** /community/machines/{id}/delist | Delist a Community Cloud machine |
 | [**enableCommunitySupplier**](CommunityApi.md#enablecommunitysupplier) | **POST** /community/suppliers | Enable the Community Cloud supplier role |
-| [**getCommunityEarnings**](CommunityApi.md#getcommunityearnings) | **GET** /community/earnings | Get your Community Cloud earnings |
-| [**getCommunityMachine**](CommunityApi.md#getcommunitymachine) | **GET** /community/machines/{id} | Get one of your Community Cloud machines |
 | [**getCommunitySupplierMe**](CommunityApi.md#getcommunitysupplierme) | **GET** /community/suppliers/me | Get the caller\'s Community Cloud supplier |
 | [**listCommunityMachines**](CommunityApi.md#listcommunitymachines) | **GET** /community/machines | List your Community Cloud machines |
 | [**reclaimCommunityMachine**](CommunityApi.md#reclaimcommunitymachine) | **POST** /community/machines/{id}/reclaim | Reclaim a spot-tier Community Cloud machine |
 | [**registerCommunityMachine**](CommunityApi.md#registercommunitymachineoperation) | **POST** /community/machines | Register a Community Cloud machine |
-| [**updateCommunityMachine**](CommunityApi.md#updatecommunitymachineoperation) | **PATCH** /community/machines/{id} | Update a Community Cloud machine\'s price |
 
 
 
@@ -165,154 +162,6 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## getCommunityEarnings
-
-> CommunityEarnings getCommunityEarnings(limit)
-
-Get your Community Cloud earnings
-
-Returns the caller org\'s supplier earnings — lifetime accrued and unpaid totals in cents plus recent ledger entries, newest first. An optional `limit` caps the ledger rows (server-clamped). Requires the `community` scope (read).
-
-### Example
-
-```ts
-import {
-  Configuration,
-  CommunityApi,
-} from '@gpuai/sdk';
-import type { GetCommunityEarningsRequest } from '@gpuai/sdk';
-
-async function example() {
-  console.log("🚀 Testing @gpuai/sdk SDK...");
-  const config = new Configuration({ 
-    // Configure HTTP bearer authorization: bearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new CommunityApi(config);
-
-  const body = {
-    // number | Maximum ledger entries to return (default 100, max 500). (optional)
-    limit: 56,
-  } satisfies GetCommunityEarningsRequest;
-
-  try {
-    const data = await api.getCommunityEarnings(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **limit** | `number` | Maximum ledger entries to return (default 100, max 500). | [Optional] [Defaults to `undefined`] |
-
-### Return type
-
-[**CommunityEarnings**](CommunityEarnings.md)
-
-### Authorization
-
-[bearerAuth](../README.md#bearerAuth)
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: `application/json`, `application/problem+json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **200** | The earnings view. |  -  |
-| **404** | The organization has not enabled the community supplier role. |  -  |
-| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
-| **0** | Error response (RFC 7807) |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-
-
-## getCommunityMachine
-
-> SupplierMachineView getCommunityMachine(id)
-
-Get one of your Community Cloud machines
-
-Returns one machine the caller\&#39;s org owns, as a supplier-facing view (&#x60;occupied&#x60;/&#x60;online&#x60; projections — the renting customer\&#39;s instance id is never exposed). A missing or cross-org machine returns 404 with an indistinguishable body. Requires the &#x60;community&#x60; scope (read).
-
-### Example
-
-```ts
-import {
-  Configuration,
-  CommunityApi,
-} from '@gpuai/sdk';
-import type { GetCommunityMachineRequest } from '@gpuai/sdk';
-
-async function example() {
-  console.log("🚀 Testing @gpuai/sdk SDK...");
-  const config = new Configuration({ 
-    // Configure HTTP bearer authorization: bearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new CommunityApi(config);
-
-  const body = {
-    // string | The machine id.
-    id: id_example,
-  } satisfies GetCommunityMachineRequest;
-
-  try {
-    const data = await api.getCommunityMachine(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **id** | `string` | The machine id. | [Defaults to `undefined`] |
-
-### Return type
-
-[**SupplierMachineView**](SupplierMachineView.md)
-
-### Authorization
-
-[bearerAuth](../README.md#bearerAuth)
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: `application/json`, `application/problem+json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **200** | The supplier-facing machine view. |  -  |
-| **404** | The machine does not exist or is not owned by the caller\&#39;s org. |  -  |
-| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
-| **0** | Error response (RFC 7807) |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-
-
 ## getCommunitySupplierMe
 
 > CommunitySupplier getCommunitySupplierMe()
@@ -598,82 +447,3 @@ example().catch(console.error);
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
-
-## updateCommunityMachine
-
-> SupplierMachineView updateCommunityMachine(id, updateCommunityMachineRequest)
-
-Update a Community Cloud machine\&#39;s price
-
-Sets the machine\&#39;s hourly price. &#x60;price_per_hour&#x60; is the WHOLE-MACHINE rate (never per-GPU). Prices below the platform floor are rejected with a &#x60;price-below-floor&#x60; problem carrying the concrete &#x60;floor_per_hour&#x60; extension member. A price change never affects an in-flight rental (its rate was snapshotted at provision); the catalog reprices on the next poll. Requires the &#x60;community&#x60; scope (or &#x60;full_access&#x60;).
-
-### Example
-
-```ts
-import {
-  Configuration,
-  CommunityApi,
-} from '@gpuai/sdk';
-import type { UpdateCommunityMachineOperationRequest } from '@gpuai/sdk';
-
-async function example() {
-  console.log("🚀 Testing @gpuai/sdk SDK...");
-  const config = new Configuration({ 
-    // Configure HTTP bearer authorization: bearerAuth
-    accessToken: "YOUR BEARER TOKEN",
-  });
-  const api = new CommunityApi(config);
-
-  const body = {
-    // string | The machine id.
-    id: id_example,
-    // UpdateCommunityMachineRequest
-    updateCommunityMachineRequest: ...,
-  } satisfies UpdateCommunityMachineOperationRequest;
-
-  try {
-    const data = await api.updateCommunityMachine(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **id** | `string` | The machine id. | [Defaults to `undefined`] |
-| **updateCommunityMachineRequest** | [UpdateCommunityMachineRequest](UpdateCommunityMachineRequest.md) |  | |
-
-### Return type
-
-[**SupplierMachineView**](SupplierMachineView.md)
-
-### Authorization
-
-[bearerAuth](../README.md#bearerAuth)
-
-### HTTP request headers
-
-- **Content-Type**: `application/json`
-- **Accept**: `application/json`, `application/problem+json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **200** | The updated supplier-facing machine view. |  -  |
-| **400** | Validation failure, including &#x60;price-below-floor&#x60; (the problem doc then carries &#x60;floor_per_hour&#x60;). |  -  |
-| **403** | The community supplier role is suspended. |  -  |
-| **404** | The machine does not exist or is not owned by the caller\&#39;s org. |  -  |
-| **429** | Rate limit exceeded (RFC 7807). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
-| **0** | Error response (RFC 7807) |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-

package/docs/CreateCryptoDepositRequest.md

@@ -0,0 +1,38 @@
+
+# CreateCryptoDepositRequest
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`amountCents` | number
+`chain` | string
+`asset` | string
+
+## Example
+
+```typescript
+import type { CreateCryptoDepositRequest } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "amountCents": null,
+  "chain": null,
+  "asset": null,
+} satisfies CreateCryptoDepositRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as CreateCryptoDepositRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/CryptoDeposit.md

@@ -0,0 +1,55 @@
+
+# CryptoDeposit
+
+A stablecoin deposit. Mirrors the Go DTO field for field. Like that struct, this schema deliberately has NO payment-processor property — the processor is an implementation detail and is structurally absent from the customer contract, not merely filtered out. 
+
+## Properties
+
+Name | Type
+------------ | -------------
+`depositId` | string
+`status` | string
+`chain` | string
+`asset` | string
+`payAddress` | string
+`payAmount` | string
+`amountUsdCents` | number
+`creditedCents` | number
+`txHash` | string
+`expiresAt` | Date
+`createdAt` | Date
+
+## Example
+
+```typescript
+import type { CryptoDeposit } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "depositId": null,
+  "status": null,
+  "chain": null,
+  "asset": null,
+  "payAddress": null,
+  "payAmount": null,
+  "amountUsdCents": null,
+  "creditedCents": null,
+  "txHash": null,
+  "expiresAt": null,
+  "createdAt": null,
+} satisfies CryptoDeposit
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as CryptoDeposit
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/Instance.md

@@ -21,6 +21,7 @@ Name | Type
 `readyAt` | Date
 `terminatedAt` | Date
 `lastReachableAt` | Date
+`unreachableSince` | Date
 
 ## Example
 
@@ -44,6 +45,7 @@ const example = {
   "readyAt": null,
   "terminatedAt": null,
   "lastReachableAt": null,
+  "unreachableSince": null,
 } satisfies Instance
 
 console.log(example)

package/docs/InstancesApi.md

@@ -268,7 +268,7 @@ async function example() {
     cursor: cursor_example,
     // number (optional)
     limit: 56,
-    // 'allocating' | 'starting' | 'running' | 'stopping' | 'stopped' | 'terminated' | 'error' | 'all' | Filter by customer-facing status (default = all non-terminated) (optional)
+    // 'allocating' | 'starting' | 'running' | 'stopping' | 'stopped' | 'terminated' | 'error' | 'all' | Filter by customer-facing status (default = all non-terminated). There is no \"unreachable\" filter value: an unreachable instance is a running instance with a dead tunnel, so it is listed under status=running and reads \"unreachable\" in the response body. (optional)
     status: status_example,
   } satisfies ListInstancesRequest;
 
@@ -291,7 +291,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **cursor** | `string` |  | [Optional] [Defaults to `undefined`] |
 | **limit** | `number` |  | [Optional] [Defaults to `50`] |
-| **status** | `allocating`, `starting`, `running`, `stopping`, `stopped`, `terminated`, `error`, `all` | Filter by customer-facing status (default = all non-terminated) | [Optional] [Defaults to `undefined`] [Enum: allocating, starting, running, stopping, stopped, terminated, error, all] |
+| **status** | `allocating`, `starting`, `running`, `stopping`, `stopped`, `terminated`, `error`, `all` | Filter by customer-facing status (default = all non-terminated). There is no \"unreachable\" filter value: an unreachable instance is a running instance with a dead tunnel, so it is listed under status=running and reads \"unreachable\" in the response body. | [Optional] [Defaults to `undefined`] [Enum: allocating, starting, running, stopping, stopped, terminated, error, all] |
 
 ### Return type
 

package/docs/ListDeposits200Response.md

@@ -0,0 +1,36 @@
+
+# ListDeposits200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`deposits` | [Array<CryptoDeposit>](CryptoDeposit.md)
+`minDepositCents` | number
+
+## Example
+
+```typescript
+import type { ListDeposits200Response } from '@gpuai/sdk'
+
+// TODO: Update the object below with actual values
+const example = {
+  "deposits": null,
+  "minDepositCents": 500,
+} satisfies ListDeposits200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ListDeposits200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpuai/sdk",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "TypeScript SDK for the GPU.ai Public Developer API",
   "author": "GPU.ai Support <support@gpu.ai>",
   "repository": {