@ar.io/sdk 3.9.1 → 3.10.0-alpha.2

package/lib/types/types/common.d.ts

@@ -27,6 +27,10 @@ export type ProcessId = string;
 export type OptionalArweave<T = NonNullable<unknown>> = {
     arweave?: Arweave;
 } & T;
+export type OptionalPaymentUrl<T = NonNullable<unknown>> = {
+    paymentUrl?: string;
+} & T;
+export type TurboArNSSigner = Signer;
 export type ContractSigner = Signer | Window['arweaveWallet'] | AoSigner;
 export type WithSigner<T = NonNullable<unknown>> = {
     signer: ContractSigner;
@@ -45,8 +49,9 @@ export type WriteOptions = {
     }[];
 };
 export type WriteParameters<Input> = WithSigner<Required<ReadParameters<Input>>>;
-export type AoMessageResult = {
+export type AoMessageResult<T = Record<string, string | number | boolean | null>> = {
     id: string;
+    result?: T;
 };
 export type AoPrimaryNameRequest = {
     name: string;

package/lib/types/types/faucet.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { AoARIORead, AoARIOWrite } from './io.js';
+export type ARIOWithFaucet<T extends AoARIORead | AoARIOWrite> = T & {
+    faucet: TokenFaucet;
+};
+export interface TokenFaucet {
+    /**
+     * Claim tokens for a process using a captcha response. This method is used to synchronously claim tokens for a process using a captcha response.
+     * @param captchaResponse - The captcha response
+     * @param recipient - The recipient address
+     * @param quantity - The quantity of tokens to claim
+     * @returns The claim id and success status
+     */
+    claimWithCaptchaResponse({ captchaResponse, recipient, quantity, }: {
+        captchaResponse: string;
+        recipient: string;
+        quantity: number;
+    }): Promise<{
+        id: string;
+        success: boolean;
+    }>;
+    /**
+     * Returns the captcha URL for a process. The captcha is used to verify a human is solving the captcha. Once you have a captcha response, you can use it to request an authorization token via the requestAuthToken method.
+     * @returns The captcha URL for a process
+     */
+    captchaUrl(): Promise<{
+        processId: string;
+        captchaUrl: string;
+    }>;
+    /**
+     * Requests an authorization token for a process. The captcha response is used to verify a human is solving the captcha. Once you have an authorization token, you can use it to claim tokens from the faucet via the claimWithAuthToken method.
+     * @param captchaResponse - The captcha response
+     * @returns The status of the request, the authorization token, and the expiration time
+     */
+    requestAuthToken({ captchaResponse }: {
+        captchaResponse: string;
+    }): Promise<{
+        status: 'success' | 'error';
+        token: string;
+        expiresAt: number;
+    }>;
+    /**
+     * Transfers tokens from the faucet wallet to a recipient address using an authorization token. To request an authorization token, solve the captcha from the captchaUrl method.
+     * @param authToken - The authorization token
+     * @param recipient - The recipient address
+     * @param quantity - The quantity of tokens to claim
+     * @returns The message id of the transfer and success status
+     */
+    claimWithAuthToken({ authToken, recipient, quantity, }: {
+        authToken: string;
+        recipient: string;
+        quantity: number;
+    }): Promise<{
+        id: string;
+        success: boolean;
+    }>;
+    /**
+     * Verifies an authorization token is valid.
+     * @param authToken - The authorization token
+     * @returns The validity of the authorization token and the expiration time
+     */
+    verifyAuthToken({ authToken }: {
+        authToken: string;
+    }): Promise<{
+        valid: boolean;
+        expiresAt: number;
+    }>;
+}

package/lib/types/types/index.d.ts

@@ -16,5 +16,6 @@
 export * from './ant-registry.js';
 export * from './ant.js';
 export * from './common.js';
+export * from './faucet.js';
 export * from './io.js';
 export * from './token.js';

package/lib/types/types/io.d.ts

@@ -310,9 +310,9 @@ export type AoTokenCostParams = {
     quantity?: number;
     fromAddress?: WalletAddress;
 };
-export declare const fundFromOptions: readonly ["balance", "stakes", "any"];
+export declare const fundFromOptions: readonly ["balance", "stakes", "any", "turbo"];
 export type FundFrom = (typeof fundFromOptions)[number];
-export declare const isValidFundFrom: (fundFrom: string) => fundFrom is "balance" | "stakes" | "any";
+export declare const isValidFundFrom: (fundFrom: string) => fundFrom is "balance" | "stakes" | "any" | "turbo";
 export type AoGetCostDetailsParams = AoTokenCostParams & {
     fundFrom?: FundFrom;
 };
@@ -338,6 +338,7 @@ export type CostDetailsResult = {
         basePrice: number;
     };
     fundingPlan?: AoFundingPlan;
+    wincQty?: string;
 };
 export type AoGetVaultParams = {
     address: WalletAddress;
@@ -523,10 +524,10 @@ export interface AoARIOWrite extends AoARIORead {
         reportTxId: TransactionId;
         failedGateways: WalletAddress[];
     }>;
-    buyRecord: AoWriteAction<AoBuyRecordParams>;
-    upgradeRecord: AoWriteAction<AoArNSPurchaseParams>;
-    extendLease: AoWriteAction<AoExtendLeaseParams>;
-    increaseUndernameLimit: AoWriteAction<AoIncreaseUndernameLimitParams>;
+    buyRecord: AoWriteAction<AoBuyRecordParams, AoMessageResult>;
+    upgradeRecord: AoWriteAction<AoArNSPurchaseParams, AoMessageResult>;
+    extendLease: AoWriteAction<AoExtendLeaseParams, AoMessageResult>;
+    increaseUndernameLimit: AoWriteAction<AoIncreaseUndernameLimitParams, AoMessageResult>;
     cancelWithdrawal: AoWriteAction<{
         gatewayAddress?: WalletAddress;
         vaultId: string;
@@ -534,7 +535,7 @@ export interface AoARIOWrite extends AoARIORead {
     requestPrimaryName: AoWriteAction<AoArNSPurchaseParams>;
     redelegateStake: AoWriteAction<AoRedelegateStakeParams>;
 }
-export declare function isProcessConfiguration(config: object): config is Required<ProcessConfiguration> & Record<string, never>;
-export declare function isProcessIdConfiguration(config: object): config is Required<ProcessIdConfig> & Record<string, never>;
+export declare function isProcessConfiguration(config: object | undefined): config is Required<ProcessConfiguration> & Record<string, never>;
+export declare function isProcessIdConfiguration(config: object | undefined): config is Required<ProcessIdConfig> & Record<string, never>;
 export declare function isLeasedArNSRecord(record: AoArNSNameData): record is AoArNSLeaseData;
 export {};

package/lib/types/utils/url.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare const urlWithSearchParams: ({ baseUrl, params, }: {
+    baseUrl: string;
+    params: Record<string, string | number | boolean | null | undefined>;
+}) => string;

package/lib/types/utils/url.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/version.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const version = "3.9.1-alpha.2";
+export declare const version = "3.10.0-alpha.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "3.9.1",
+  "version": "3.10.0-alpha.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"
@@ -67,7 +67,7 @@
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "format": "prettier --check .",
-    "format:fix": "prettier --write .",
+    "format:fix": "prettier --write . && yarn docs:update",
     "test": "yarn test:unit && yarn test:e2e",
     "test:cjs": "yarn build:cjs && yarn link && cd ./tests/e2e/cjs && yarn && yarn test",
     "test:esm": "yarn build:esm && yarn link && cd ./tests/e2e/esm && yarn && yarn test",
@@ -77,7 +77,7 @@
     "test:e2e": "yarn test:cjs && yarn test:esm && yarn test:web",
     "test:integration": "yarn build:esm && yarn link && cd ./tests/integration && yarn && yarn test",
     "prepare": "husky install",
-    "docs:update": "markdown-toc-gen insert README.md",
+    "docs:update": "markdown-toc-gen insert README.md --max-depth 2",
     "example:esm": "cd examples/esm && yarn && node index.mjs",
     "example:cjs": "yarn build:cjs && yarn link && cd examples/cjs && yarn && node index.cjs",
     "example:web": "yarn build:web && http-server --port 8080 --host -o examples/web",
@@ -100,7 +100,7 @@
     "arconnect": "^1.0.3",
     "dotenv": "^16.4.5",
     "dotenv-cli": "^7.4.2",
-    "esbuild": "^0.25.1",
+    "esbuild": "^0.25.2",
     "esbuild-plugin-polyfill-node": "^0.3.0",
     "eslint": "^8.47.0",
     "eslint-config-prettier": "^9.0.0",
@@ -121,8 +121,7 @@
     "sinon": "^15.2.0",
     "testcontainers": "^10.13.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.1.6",
-    "vite-plugin-node-polyfills": "^0.22.0"
+    "typescript": "^5.1.6"
   },
   "dependencies": {
     "@dha-team/arbundles": "^1.0.1",
@@ -134,6 +133,7 @@
     "eventemitter3": "^5.0.1",
     "plimit-lit": "^3.0.1",
     "prompts": "^2.4.2",
+    "uuid": "^11.1.0",
     "winston": "^3.13.0",
     "zod": "^3.23.8"
   },
@@ -142,7 +142,7 @@
       "prettier --write ."
     ],
     "**/README.md": [
-      "markdown-toc-gen insert"
+      "markdown-toc-gen insert --max-depth 2"
     ]
   }
 }