@privy-io/api-types 0.7.0 → 0.9.0

package/src/resources/shared.ts

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+
+export class Shared extends APIResource {}
+
+/**
+ * A simple success response.
+ */
+export interface SuccessResponse {
+  success: boolean;
+}
+
+/**
+ * A P-256 (secp256r1) public key.
+ */
+export type P256PublicKey = string;
+
+/**
+ * A unique identifier for a key quorum.
+ */
+export type KeyQuorumID = string;
+
+/**
+ * Owner input specifying a Privy user ID.
+ */
+export interface OwnerInputUser {
+  user_id: string;
+}
+
+/**
+ * Owner input specifying a P-256 public key.
+ */
+export interface OwnerInputPublicKey {
+  /**
+   * A P-256 (secp256r1) public key.
+   */
+  public_key: P256PublicKey;
+}
+
+/**
+ * The owner of the resource, specified as a Privy user ID, a P-256 public key, or
+ * null to remove the current owner.
+ */
+export type OwnerInput = OwnerInputUser | OwnerInputPublicKey;
+
+/**
+ * The key quorum ID to set as the owner of the resource. If you provide this, do
+ * not specify an owner.
+ */
+export type OwnerIDInput = string | null;
+
+/**
+ * A monetary value with its currency denomination.
+ */
+export interface CurrencyAmount {
+  /**
+   * Currency code
+   */
+  currency: 'usd';
+
+  /**
+   * The monetary value as a string.
+   */
+  value: string;
+}
+
+export declare namespace Shared {
+  export {
+    type SuccessResponse as SuccessResponse,
+    type P256PublicKey as P256PublicKey,
+    type KeyQuorumID as KeyQuorumID,
+    type OwnerInputUser as OwnerInputUser,
+    type OwnerInputPublicKey as OwnerInputPublicKey,
+    type OwnerInput as OwnerInput,
+    type OwnerIDInput as OwnerIDInput,
+    type CurrencyAmount as CurrencyAmount,
+  };
+}

package/src/resources/swaps.ts

@@ -0,0 +1,136 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+
+export class Swaps extends APIResource {}
+
+/**
+ * Whether the swap amount refers to the input token or output token.
+ */
+export type SwapAmountType = 'exact_input' | 'exact_output';
+
+/**
+ * Input for requesting a token swap quote.
+ */
+export interface SwapQuoteRequestBody {
+  /**
+   * Amount in base units (e.g., wei for ETH).
+   */
+  amount: string;
+
+  /**
+   * Chain identifier (e.g., "eip155:1" for Ethereum mainnet).
+   */
+  caip2: string;
+
+  /**
+   * Token address to sell, or "native" for the chain's native token.
+   */
+  input_token: string;
+
+  /**
+   * Token address to buy, or "native" for the chain's native token.
+   */
+  output_token: string;
+
+  /**
+   * Whether the swap amount refers to the input token or output token.
+   */
+  amount_type?: SwapAmountType;
+
+  /**
+   * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%). If omitted,
+   * auto-slippage is used.
+   */
+  slippage_bps?: number;
+}
+
+/**
+ * Pricing data for a token swap.
+ */
+export interface SwapQuoteResponse {
+  /**
+   * Chain identifier.
+   */
+  caip2: string;
+
+  /**
+   * Estimated amount of output token in base units.
+   */
+  est_output_amount: string;
+
+  /**
+   * Estimated gas cost in base units of the native token.
+   */
+  gas_estimate: string;
+
+  /**
+   * Amount of input token in base units.
+   */
+  input_amount: string;
+
+  /**
+   * Token address being sold.
+   */
+  input_token: string;
+
+  /**
+   * Minimum output amount accounting for slippage, in base units.
+   */
+  minimum_output_amount: string;
+
+  /**
+   * Token address being bought.
+   */
+  output_token: string;
+}
+
+/**
+ * Input for executing a token swap.
+ */
+export interface SwapRequestBody {
+  /**
+   * Amount in base units (e.g., wei for ETH).
+   */
+  amount: string;
+
+  /**
+   * Chain identifier (e.g., "eip155:1" for Ethereum mainnet).
+   */
+  caip2: string;
+
+  /**
+   * Token address to sell, or "native" for the chain's native token.
+   */
+  input_token: string;
+
+  /**
+   * Token address to buy, or "native" for the chain's native token.
+   */
+  output_token: string;
+
+  /**
+   * Whether the swap amount refers to the input token or output token.
+   */
+  amount_type?: SwapAmountType;
+
+  /**
+   * Address to receive the output tokens. Defaults to the wallet address if not
+   * specified.
+   */
+  recipient?: string;
+
+  /**
+   * Maximum slippage tolerance in basis points (e.g., 50 for 0.5%).
+   */
+  slippage_bps?: number;
+}
+
+export declare namespace Swaps {
+  export {
+    type SwapAmountType as SwapAmountType,
+    type SwapQuoteRequestBody as SwapQuoteRequestBody,
+    type SwapQuoteResponse as SwapQuoteResponse,
+    type SwapRequestBody as SwapRequestBody,
+  };
+}

package/src/resources/transactions.ts

@@ -19,7 +19,7 @@ export class Transactions extends APIResource {
    * );
    * ```
    */
-  get(transactionID: string, options?: RequestOptions): APIPromise<TransactionGetResponse> {
+  get(transactionID: string, options?: RequestOptions): APIPromise<Transaction> {
     return this._client.get(path`/v1/transactions/${transactionID}`, options);
   }
 }
@@ -30,155 +30,196 @@ export class Transactions extends APIResource {
 export interface TransactionScanningRequestBody {
   chain_id: string;
 
-  metadata: TransactionScanningRequestBody.Metadata;
-
-  request: TransactionScanningRequestBody.Request;
-}
-
-export namespace TransactionScanningRequestBody {
-  export interface Metadata {
-    domain: string;
-  }
-
-  export interface Request {
-    method: string;
+  /**
+   * Additional information for Blockaid to validate against.
+   */
+  metadata: TransactionScanningMetadata;
 
-    params: Array<unknown>;
-  }
+  /**
+   * Raw RPC request to execute with the wallet.
+   */
+  request: TransactionScanningRpcRequest;
 }
 
 /**
  * The response from scanning a transaction.
  */
 export interface TransactionScanningResponseBody {
-  simulation: TransactionScanningResponseBody.UnionMember0 | TransactionScanningResponseBody.UnionMember1;
+  /**
+   * The simulation result from a transaction scan.
+   */
+  simulation: TransactionScanningSimulationResult;
 
-  validation: TransactionScanningResponseBody.UnionMember0 | TransactionScanningResponseBody.UnionMember1;
+  /**
+   * The validation result from a transaction scan.
+   */
+  validation: TransactionScanningValidationResult;
 }
 
-export namespace TransactionScanningResponseBody {
-  export interface UnionMember0 {
-    error: string;
-
-    status: 'Error';
-  }
-
-  export interface UnionMember1 {
-    assets_diffs: Array<UnionMember1.AssetsDiff>;
-
-    exposures: Array<UnionMember1.Exposure>;
-
-    status: 'Success';
-
-    params?: UnionMember1.Params;
-  }
+/**
+ * Additional information for Blockaid to validate against.
+ */
+export interface TransactionScanningMetadata {
+  domain: string;
+}
 
-  export namespace UnionMember1 {
-    export interface AssetsDiff {
-      asset: AssetsDiff.Asset;
+/**
+ * Raw RPC request to execute with the wallet.
+ */
+export interface TransactionScanningRpcRequest {
+  method: string;
 
-      in: Array<AssetsDiff.In>;
+  params: Array<unknown>;
+}
 
-      out: Array<AssetsDiff.Out>;
-    }
+/**
+ * A failed validation result from a transaction scan.
+ */
+export interface TransactionScanningValidationErrorResult {
+  error: string;
 
-    export namespace AssetsDiff {
-      export interface Asset {
-        decimals?: number;
+  status: 'Error';
+}
 
-        logo_url?: string;
+/**
+ * A successful validation result from a transaction scan.
+ */
+export interface TransactionScanningValidationSuccessResult {
+  result_type: string;
 
-        name?: string;
+  status: 'Success';
+}
 
-        symbol?: string;
+/**
+ * The validation result from a transaction scan.
+ */
+export type TransactionScanningValidationResult =
+  | TransactionScanningValidationErrorResult
+  | TransactionScanningValidationSuccessResult;
 
-        type?: string;
-      }
+/**
+ * Information about the moving asset in a transaction scan.
+ */
+export interface TransactionScanningAssetInfo {
+  decimals?: number;
 
-      export interface In {
-        usd_price?: string;
+  logo_url?: string;
 
-        value?: string;
-      }
+  name?: string;
 
-      export interface Out {
-        usd_price?: string;
+  symbol?: string;
 
-        value?: string;
-      }
-    }
+  type?: string;
+}
 
-    export interface Exposure {
-      asset: Exposure.Asset;
+/**
+ * The value of an asset in a transaction scan result.
+ */
+export interface TransactionScanningAssetValue {
+  usd_price?: string;
 
-      spenders: { [key: string]: Exposure.Spenders };
-    }
+  value?: string;
+}
 
-    export namespace Exposure {
-      export interface Asset {
-        decimals?: number;
+/**
+ * An asset diff representing assets entering/leaving a wallet.
+ */
+export interface TransactionScanningAssetDiff {
+  /**
+   * Information about the moving asset in a transaction scan.
+   */
+  asset: TransactionScanningAssetInfo;
 
-        logo_url?: string;
+  in: Array<TransactionScanningAssetValue>;
 
-        name?: string;
+  out: Array<TransactionScanningAssetValue>;
+}
 
-        symbol?: string;
+/**
+ * An exposure representing assets approved to spend.
+ */
+export interface TransactionScanningExposure {
+  /**
+   * Information about the moving asset in a transaction scan.
+   */
+  asset: TransactionScanningAssetInfo;
 
-        type?: string;
-      }
+  spenders: { [key: string]: TransactionScanningAssetValue };
+}
 
-      export interface Spenders {
-        usd_price?: string;
+/**
+ * Decoded calldata from a scanned transaction.
+ */
+export interface TransactionScanningCalldata {
+  function_selector: string;
 
-        value?: string;
-      }
-    }
+  function_declaration?: string;
 
-    export interface Params {
-      block_tag?: string;
+  function_signature?: string;
+}
 
-      calldata?: Params.Calldata;
+/**
+ * The parameters of the scanned transaction.
+ */
+export interface TransactionScanningParams {
+  block_tag?: string;
 
-      chain?: string;
+  /**
+   * Decoded calldata from a scanned transaction.
+   */
+  calldata?: TransactionScanningCalldata;
 
-      data?: string;
+  chain?: string;
 
-      from?: string;
+  data?: string;
 
-      gas?: string;
+  from?: string;
 
-      gas_price?: string;
+  gas?: string;
 
-      to?: string;
+  gas_price?: string;
 
-      value?: string;
-    }
+  to?: string;
 
-    export namespace Params {
-      export interface Calldata {
-        function_selector: string;
+  value?: string;
+}
 
-        function_declaration?: string;
+/**
+ * A failed simulation result from a transaction scan.
+ */
+export interface TransactionScanningSimulationErrorResult {
+  error: string;
 
-        function_signature?: string;
-      }
-    }
-  }
+  status: 'Error';
+}
 
-  export interface UnionMember0 {
-    error: string;
+/**
+ * A successful simulation result from a transaction scan.
+ */
+export interface TransactionScanningSimulationSuccessResult {
+  assets_diffs: Array<TransactionScanningAssetDiff>;
 
-    status: 'Error';
-  }
+  exposures: Array<TransactionScanningExposure>;
 
-  export interface UnionMember1 {
-    result_type: string;
+  status: 'Success';
 
-    status: 'Success';
-  }
+  /**
+   * The parameters of the scanned transaction.
+   */
+  params?: TransactionScanningParams;
 }
 
-export interface TransactionGetResponse {
+/**
+ * The simulation result from a transaction scan.
+ */
+export type TransactionScanningSimulationResult =
+  | TransactionScanningSimulationErrorResult
+  | TransactionScanningSimulationSuccessResult;
+
+/**
+ * A transaction from a Privy wallet.
+ */
+export interface Transaction {
   id: string;
 
   caip2: string;
@@ -199,13 +240,39 @@ export interface TransactionGetResponse {
 
   wallet_id: string;
 
+  reference_id?: string | null;
+
   sponsored?: boolean;
+
+  user_operation_hash?: string;
+}
+
+/**
+ * A list of transactions.
+ */
+export interface TransactionList {
+  transactions: Array<Transaction>;
 }
 
 export declare namespace Transactions {
   export {
     type TransactionScanningRequestBody as TransactionScanningRequestBody,
     type TransactionScanningResponseBody as TransactionScanningResponseBody,
-    type TransactionGetResponse as TransactionGetResponse,
+    type TransactionScanningMetadata as TransactionScanningMetadata,
+    type TransactionScanningRpcRequest as TransactionScanningRpcRequest,
+    type TransactionScanningValidationErrorResult as TransactionScanningValidationErrorResult,
+    type TransactionScanningValidationSuccessResult as TransactionScanningValidationSuccessResult,
+    type TransactionScanningValidationResult as TransactionScanningValidationResult,
+    type TransactionScanningAssetInfo as TransactionScanningAssetInfo,
+    type TransactionScanningAssetValue as TransactionScanningAssetValue,
+    type TransactionScanningAssetDiff as TransactionScanningAssetDiff,
+    type TransactionScanningExposure as TransactionScanningExposure,
+    type TransactionScanningCalldata as TransactionScanningCalldata,
+    type TransactionScanningParams as TransactionScanningParams,
+    type TransactionScanningSimulationErrorResult as TransactionScanningSimulationErrorResult,
+    type TransactionScanningSimulationSuccessResult as TransactionScanningSimulationSuccessResult,
+    type TransactionScanningSimulationResult as TransactionScanningSimulationResult,
+    type Transaction as Transaction,
+    type TransactionList as TransactionList,
   };
 }