@turnkey/core 1.8.3 → 1.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__clients__/core.d.ts +65 -3
- package/dist/__clients__/core.d.ts.map +1 -1
- package/dist/__clients__/core.js +176 -5
- package/dist/__clients__/core.js.map +1 -1
- package/dist/__clients__/core.mjs +176 -5
- package/dist/__clients__/core.mjs.map +1 -1
- package/dist/__generated__/sdk-client-base.d.ts +6 -0
- package/dist/__generated__/sdk-client-base.d.ts.map +1 -1
- package/dist/__generated__/sdk-client-base.js +392 -119
- package/dist/__generated__/sdk-client-base.js.map +1 -1
- package/dist/__generated__/sdk-client-base.mjs +392 -119
- package/dist/__generated__/sdk-client-base.mjs.map +1 -1
- package/dist/__generated__/version.d.ts +1 -1
- package/dist/__generated__/version.d.ts.map +1 -1
- package/dist/__generated__/version.js +1 -1
- package/dist/__generated__/version.mjs +1 -1
- package/dist/__inputs__/public_api.types.d.ts +158 -20
- package/dist/__inputs__/public_api.types.d.ts.map +1 -1
- package/dist/__types__/method-types/shared.d.ts +25 -0
- package/dist/__types__/method-types/shared.d.ts.map +1 -1
- package/package.json +5 -5
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { TurnkeySDKClientBase } from "../__generated__/sdk-client-base";
|
|
2
|
-
import { type TDeleteSubOrganizationResponse, type Session, type TStampLoginResponse, type v1SignRawPayloadResult, type v1User, type ProxyTGetWalletKitConfigResponse, type v1PrivateKey, type WalletAuthResult, type BaseAuthResult, AuthAction, type PasskeyAuthResult, type v1BootProof } from "@turnkey/sdk-types";
|
|
3
|
-
import { Chain, type ExportBundle, type TurnkeySDKClientConfig, type WalletAccount, type Wallet, type WalletManagerBase, type WalletProvider, type CreatePasskeyParams, type CreatePasskeyResult, type LogoutParams, type LoginWithPasskeyParams, type SignUpWithPasskeyParams, type SwitchWalletAccountChainParams, type LoginWithWalletParams, type SignUpWithWalletParams, type LoginOrSignupWithWalletParams, type InitOtpParams, type VerifyOtpParams, type VerifyOtpResult, type LoginWithOtpParams, type SignUpWithOtpParams, type CompleteOtpParams, type CompleteOauthParams, type LoginWithOauthParams, type SignUpWithOauthParams, type FetchWalletsParams, type FetchWalletAccountsParams, type FetchPrivateKeysParams, type SignMessageParams, type SignTransactionParams, type SignAndSendTransactionParams, type FetchUserParams, type FetchOrCreateP256ApiKeyUserParams, type FetchOrCreatePoliciesParams, type FetchOrCreatePoliciesResult, type UpdateUserEmailParams, type RemoveUserEmailParams, type UpdateUserPhoneNumberParams, type RemoveUserPhoneNumberParams, type UpdateUserNameParams, type AddOauthProviderParams, type RemoveOauthProvidersParams, type AddPasskeyParams, type RemovePasskeyParams, type CreateWalletParams, type CreateWalletAccountsParams, type ExportWalletParams, type ExportPrivateKeyParams, type ExportWalletAccountParams, type ImportWalletParams, type ImportPrivateKeyParams, type DeleteSubOrganizationParams, type StoreSessionParams, type ClearSessionParams, type RefreshSessionParams, type GetSessionParams, type SetActiveSessionParams, type CreateApiKeyPairParams, type FetchBootProofForAppProofParams, type CreateHttpClientParams, type BuildWalletLoginRequestResult, type BuildWalletLoginRequestParams, type VerifyAppProofsParams } from "../__types__";
|
|
2
|
+
import { type TDeleteSubOrganizationResponse, type Session, type TStampLoginResponse, type v1SignRawPayloadResult, type v1User, type ProxyTGetWalletKitConfigResponse, type v1PrivateKey, type WalletAuthResult, type BaseAuthResult, AuthAction, type PasskeyAuthResult, type v1BootProof, type TGetSendTransactionStatusResponse } from "@turnkey/sdk-types";
|
|
3
|
+
import { Chain, type ExportBundle, type TurnkeySDKClientConfig, type WalletAccount, type Wallet, type WalletManagerBase, type WalletProvider, type CreatePasskeyParams, type CreatePasskeyResult, type LogoutParams, type LoginWithPasskeyParams, type SignUpWithPasskeyParams, type SwitchWalletAccountChainParams, type LoginWithWalletParams, type SignUpWithWalletParams, type LoginOrSignupWithWalletParams, type InitOtpParams, type VerifyOtpParams, type VerifyOtpResult, type LoginWithOtpParams, type SignUpWithOtpParams, type CompleteOtpParams, type CompleteOauthParams, type LoginWithOauthParams, type SignUpWithOauthParams, type FetchWalletsParams, type FetchWalletAccountsParams, type FetchPrivateKeysParams, type SignMessageParams, type SignTransactionParams, type SignAndSendTransactionParams, type EthSendTransactionParams, type FetchUserParams, type FetchOrCreateP256ApiKeyUserParams, type FetchOrCreatePoliciesParams, type FetchOrCreatePoliciesResult, type UpdateUserEmailParams, type RemoveUserEmailParams, type UpdateUserPhoneNumberParams, type RemoveUserPhoneNumberParams, type UpdateUserNameParams, type AddOauthProviderParams, type RemoveOauthProvidersParams, type AddPasskeyParams, type RemovePasskeyParams, type CreateWalletParams, type CreateWalletAccountsParams, type ExportWalletParams, type ExportPrivateKeyParams, type ExportWalletAccountParams, type ImportWalletParams, type ImportPrivateKeyParams, type DeleteSubOrganizationParams, type StoreSessionParams, type ClearSessionParams, type RefreshSessionParams, type GetSessionParams, type SetActiveSessionParams, type CreateApiKeyPairParams, type FetchBootProofForAppProofParams, type CreateHttpClientParams, type BuildWalletLoginRequestResult, type BuildWalletLoginRequestParams, type VerifyAppProofsParams, type PollTransactionStatusParams } from "../__types__";
|
|
4
4
|
import { CrossPlatformApiKeyStamper } from "../__stampers__/api/base";
|
|
5
5
|
import { CrossPlatformPasskeyStamper } from "../__stampers__/passkey/base";
|
|
6
6
|
/**
|
|
@@ -547,6 +547,68 @@ export declare class TurnkeyClient {
|
|
|
547
547
|
* @throws {TurnkeyError} If the wallet type is unsupported, or if signing/broadcasting fails.
|
|
548
548
|
*/
|
|
549
549
|
signAndSendTransaction: (params: SignAndSendTransactionParams) => Promise<string>;
|
|
550
|
+
/**
|
|
551
|
+
* @beta
|
|
552
|
+
* * **API subject to change**
|
|
553
|
+
*
|
|
554
|
+
* Signs and submits an Ethereum transaction using a Turnkey-managed (embedded) wallet.
|
|
555
|
+
*
|
|
556
|
+
* This method performs **authorization and signing**, and submits the transaction
|
|
557
|
+
* to Turnkey’s coordinator. It **does not perform any polling** — callers must use
|
|
558
|
+
* `pollTransactionStatus` to obtain the final on-chain result.
|
|
559
|
+
*
|
|
560
|
+
* Behavior:
|
|
561
|
+
*
|
|
562
|
+
* - **Connected wallets**
|
|
563
|
+
* - Connected wallets are **not supported** by this method.
|
|
564
|
+
* - They must instead use `signAndSendTransaction`.
|
|
565
|
+
*
|
|
566
|
+
* - **Embedded wallets**
|
|
567
|
+
* - Constructs the payload for Turnkey's `eth_send_transaction` endpoint.
|
|
568
|
+
* - Fetches nonces automatically when needed (normal nonce or Gas Station nonce).
|
|
569
|
+
* - Signs and submits the transaction through Turnkey.
|
|
570
|
+
* - Returns a `sendTransactionStatusId`, which the caller must pass to
|
|
571
|
+
* `pollTransactionStatus` to obtain the final result (tx hash + status).
|
|
572
|
+
*
|
|
573
|
+
* @param params.organizationId - Organization ID to execute the transaction under.
|
|
574
|
+
* Defaults to the active session's organization.
|
|
575
|
+
*
|
|
576
|
+
* @param params.stampWith - Optional stamper to authorize signing (e.g., passkey).
|
|
577
|
+
*
|
|
578
|
+
* @param params.transaction - The Ethereum transaction details.
|
|
579
|
+
* @returns A promise resolving to the `sendTransactionStatusId`.
|
|
580
|
+
* This ID must be passed to `pollTransactionStatus`.
|
|
581
|
+
*
|
|
582
|
+
* @throws {TurnkeyError} If the transaction is invalid or Turnkey rejects it.
|
|
583
|
+
*/
|
|
584
|
+
ethSendTransaction: (params: EthSendTransactionParams) => Promise<string>;
|
|
585
|
+
/**
|
|
586
|
+
* @beta
|
|
587
|
+
* **API subject to change**
|
|
588
|
+
*
|
|
589
|
+
* Polls Turnkey for the final result of a previously submitted Ethereum transaction.
|
|
590
|
+
*
|
|
591
|
+
* This function repeatedly calls `getSendTransactionStatus` until the transaction
|
|
592
|
+
* reaches a terminal state.
|
|
593
|
+
*
|
|
594
|
+
* Terminal states:
|
|
595
|
+
* - **COMPLETED** or **INCLUDED** → resolves with `{ txHash }`
|
|
596
|
+
* - **FAILED** rejects with an error
|
|
597
|
+
*
|
|
598
|
+
* Behavior:
|
|
599
|
+
*
|
|
600
|
+
* - Queries Turnkey every 500ms.
|
|
601
|
+
* - Stops polling automatically when a terminal state is reached.
|
|
602
|
+
* - Extracts the canonical on-chain hash via `resp.eth.txHash` when available.
|
|
603
|
+
*
|
|
604
|
+
* @param organizationId - Organization ID under which the transaction was submitted.
|
|
605
|
+
* @param sendTransactionStatusId - Status ID returned by `ethSendTransaction.
|
|
606
|
+
* @param pollingIntervalMs - Optional polling interval in milliseconds (default: 500ms).
|
|
607
|
+
*
|
|
608
|
+
* @returns A promise resolving to `{ txHash?: string }` if successful.
|
|
609
|
+
* @throws {Error | string} If the transaction fails or is cancelled.
|
|
610
|
+
*/
|
|
611
|
+
pollTransactionStatus(params: PollTransactionStatusParams): Promise<TGetSendTransactionStatusResponse>;
|
|
550
612
|
/**
|
|
551
613
|
* Fetches the user details for the current session or a specified user.
|
|
552
614
|
*
|
|
@@ -1036,7 +1098,7 @@ export declare class TurnkeyClient {
|
|
|
1036
1098
|
*
|
|
1037
1099
|
* @param params.externalKeyPair - An externally generated key pair (either a CryptoKeyPair or an object with publicKey/privateKey strings) to use instead of generating a new one.
|
|
1038
1100
|
* @param params.storeOverride - If true, sets the generated or provided public key as the override key in the API key stamper (defaults to false).
|
|
1039
|
-
* @
|
|
1101
|
+
* @return A promise that resolves to the public key of the created or provided API key pair as a string.
|
|
1040
1102
|
* @throws {TurnkeyError} If the API key stamper is not initialized or if there is an error during key pair creation or storage.
|
|
1041
1103
|
*/
|
|
1042
1104
|
createApiKeyPair: (params?: CreateApiKeyPairParams) => Promise<string>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/__clients__/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,OAAO,EACZ,KAAK,mBAAmB,EAExB,KAAK,sBAAsB,EAC3B,KAAK,MAAM,EAGX,KAAK,gCAAgC,EAErC,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,iBAAiB,EAEtB,KAAK,WAAW,
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/__clients__/core.ts"],"names":[],"mappings":"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"}
|
package/dist/__clients__/core.js
CHANGED
|
@@ -581,8 +581,6 @@ class TurnkeyClient {
|
|
|
581
581
|
errorCode: sdkTypes.TurnkeyErrorCodes.WALLET_LOGIN_AUTH_ERROR,
|
|
582
582
|
}, {
|
|
583
583
|
finallyFn: async () => {
|
|
584
|
-
// Clean up the generated key pair if it wasn't successfully used
|
|
585
|
-
this.apiKeyStamper?.clearTemporaryPublicKey();
|
|
586
584
|
if (generatedPublicKey) {
|
|
587
585
|
try {
|
|
588
586
|
await this.apiKeyStamper?.deleteKeyPair(generatedPublicKey);
|
|
@@ -675,7 +673,6 @@ class TurnkeyClient {
|
|
|
675
673
|
errorCode: sdkTypes.TurnkeyErrorCodes.WALLET_SIGNUP_AUTH_ERROR,
|
|
676
674
|
}, {
|
|
677
675
|
finallyFn: async () => {
|
|
678
|
-
// Clean up the generated key pair if it wasn't successfully used
|
|
679
676
|
this.apiKeyStamper?.clearTemporaryPublicKey();
|
|
680
677
|
if (generatedPublicKey) {
|
|
681
678
|
try {
|
|
@@ -1735,6 +1732,110 @@ class TurnkeyClient {
|
|
|
1735
1732
|
errorCode: sdkTypes.TurnkeyErrorCodes.SIGN_AND_SEND_TRANSACTION_ERROR,
|
|
1736
1733
|
});
|
|
1737
1734
|
};
|
|
1735
|
+
/**
|
|
1736
|
+
* @beta
|
|
1737
|
+
* * **API subject to change**
|
|
1738
|
+
*
|
|
1739
|
+
* Signs and submits an Ethereum transaction using a Turnkey-managed (embedded) wallet.
|
|
1740
|
+
*
|
|
1741
|
+
* This method performs **authorization and signing**, and submits the transaction
|
|
1742
|
+
* to Turnkey’s coordinator. It **does not perform any polling** — callers must use
|
|
1743
|
+
* `pollTransactionStatus` to obtain the final on-chain result.
|
|
1744
|
+
*
|
|
1745
|
+
* Behavior:
|
|
1746
|
+
*
|
|
1747
|
+
* - **Connected wallets**
|
|
1748
|
+
* - Connected wallets are **not supported** by this method.
|
|
1749
|
+
* - They must instead use `signAndSendTransaction`.
|
|
1750
|
+
*
|
|
1751
|
+
* - **Embedded wallets**
|
|
1752
|
+
* - Constructs the payload for Turnkey's `eth_send_transaction` endpoint.
|
|
1753
|
+
* - Fetches nonces automatically when needed (normal nonce or Gas Station nonce).
|
|
1754
|
+
* - Signs and submits the transaction through Turnkey.
|
|
1755
|
+
* - Returns a `sendTransactionStatusId`, which the caller must pass to
|
|
1756
|
+
* `pollTransactionStatus` to obtain the final result (tx hash + status).
|
|
1757
|
+
*
|
|
1758
|
+
* @param params.organizationId - Organization ID to execute the transaction under.
|
|
1759
|
+
* Defaults to the active session's organization.
|
|
1760
|
+
*
|
|
1761
|
+
* @param params.stampWith - Optional stamper to authorize signing (e.g., passkey).
|
|
1762
|
+
*
|
|
1763
|
+
* @param params.transaction - The Ethereum transaction details.
|
|
1764
|
+
* @returns A promise resolving to the `sendTransactionStatusId`.
|
|
1765
|
+
* This ID must be passed to `pollTransactionStatus`.
|
|
1766
|
+
*
|
|
1767
|
+
* @throws {TurnkeyError} If the transaction is invalid or Turnkey rejects it.
|
|
1768
|
+
*/
|
|
1769
|
+
this.ethSendTransaction = async (params) => {
|
|
1770
|
+
const { organizationId: organizationIdFromParams, stampWith = this.config.defaultStamperType, transaction, } = params;
|
|
1771
|
+
const { from, to, caip2, value, data, nonce, gasLimit, maxFeePerGas, maxPriorityFeePerGas, sponsor, } = transaction;
|
|
1772
|
+
const session = await utils.getActiveSessionOrThrowIfRequired(stampWith, this.storageManager.getActiveSession);
|
|
1773
|
+
const organizationId = organizationIdFromParams || session?.organizationId;
|
|
1774
|
+
if (!organizationId) {
|
|
1775
|
+
throw new sdkTypes.TurnkeyError("Organization ID must be provided to send a transaction", sdkTypes.TurnkeyErrorCodes.INVALID_REQUEST);
|
|
1776
|
+
}
|
|
1777
|
+
return utils.withTurnkeyErrorHandling(async () => {
|
|
1778
|
+
let gasStationNonce;
|
|
1779
|
+
let fetchedNonce;
|
|
1780
|
+
//
|
|
1781
|
+
// Fetch nonce(s) when needed:
|
|
1782
|
+
// - sponsored: Gas Station nonce
|
|
1783
|
+
// - non-sponsored: regular EIP-1559 nonce
|
|
1784
|
+
//
|
|
1785
|
+
if (!nonce || sponsor) {
|
|
1786
|
+
const nonceResp = await this.httpClient.getNonces({
|
|
1787
|
+
organizationId,
|
|
1788
|
+
address: from,
|
|
1789
|
+
caip2,
|
|
1790
|
+
nonce: sponsor ? false : true,
|
|
1791
|
+
gasStationNonce: sponsor ? true : false,
|
|
1792
|
+
});
|
|
1793
|
+
gasStationNonce = nonceResp.gasStationNonce;
|
|
1794
|
+
fetchedNonce = nonceResp.nonce;
|
|
1795
|
+
}
|
|
1796
|
+
const finalNonce = nonce ?? fetchedNonce;
|
|
1797
|
+
//
|
|
1798
|
+
// Build Turnkey intent
|
|
1799
|
+
//
|
|
1800
|
+
const intent = {
|
|
1801
|
+
from,
|
|
1802
|
+
to,
|
|
1803
|
+
caip2,
|
|
1804
|
+
...(value ? { value } : {}),
|
|
1805
|
+
...(data ? { data } : {}),
|
|
1806
|
+
};
|
|
1807
|
+
if (sponsor) {
|
|
1808
|
+
intent.sponsor = true;
|
|
1809
|
+
if (gasStationNonce)
|
|
1810
|
+
intent.gasStationNonce = gasStationNonce;
|
|
1811
|
+
}
|
|
1812
|
+
else {
|
|
1813
|
+
if (finalNonce !== undefined)
|
|
1814
|
+
intent.nonce = finalNonce;
|
|
1815
|
+
if (gasLimit)
|
|
1816
|
+
intent.gasLimit = gasLimit;
|
|
1817
|
+
if (maxFeePerGas)
|
|
1818
|
+
intent.maxFeePerGas = maxFeePerGas;
|
|
1819
|
+
if (maxPriorityFeePerGas)
|
|
1820
|
+
intent.maxPriorityFeePerGas = maxPriorityFeePerGas;
|
|
1821
|
+
}
|
|
1822
|
+
//
|
|
1823
|
+
// Submit to Turnkey
|
|
1824
|
+
//
|
|
1825
|
+
const resp = await this.httpClient.ethSendTransaction({
|
|
1826
|
+
...intent,
|
|
1827
|
+
organizationId,
|
|
1828
|
+
});
|
|
1829
|
+
const id = resp.sendTransactionStatusId;
|
|
1830
|
+
if (!id) {
|
|
1831
|
+
throw new sdkTypes.TurnkeyError("Missing sendTransactionStatusId", sdkTypes.TurnkeyErrorCodes.ETH_SEND_TRANSACTION_ERROR);
|
|
1832
|
+
}
|
|
1833
|
+
return id;
|
|
1834
|
+
}, {
|
|
1835
|
+
errorMessage: "Failed to sign and send Ethereum transaction",
|
|
1836
|
+
errorCode: sdkTypes.TurnkeyErrorCodes.ETH_SEND_TRANSACTION_ERROR,
|
|
1837
|
+
});
|
|
1838
|
+
};
|
|
1738
1839
|
/**
|
|
1739
1840
|
* Fetches the user details for the current session or a specified user.
|
|
1740
1841
|
*
|
|
@@ -2977,7 +3078,7 @@ class TurnkeyClient {
|
|
|
2977
3078
|
*
|
|
2978
3079
|
* @param params.externalKeyPair - An externally generated key pair (either a CryptoKeyPair or an object with publicKey/privateKey strings) to use instead of generating a new one.
|
|
2979
3080
|
* @param params.storeOverride - If true, sets the generated or provided public key as the override key in the API key stamper (defaults to false).
|
|
2980
|
-
* @
|
|
3081
|
+
* @return A promise that resolves to the public key of the created or provided API key pair as a string.
|
|
2981
3082
|
* @throws {TurnkeyError} If the API key stamper is not initialized or if there is an error during key pair creation or storage.
|
|
2982
3083
|
*/
|
|
2983
3084
|
this.createApiKeyPair = async (params) => {
|
|
@@ -2989,7 +3090,7 @@ class TurnkeyClient {
|
|
|
2989
3090
|
}
|
|
2990
3091
|
const publicKey = await this.apiKeyStamper.createKeyPair(externalKeyPair ? externalKeyPair : undefined);
|
|
2991
3092
|
if (storeOverride && publicKey) {
|
|
2992
|
-
|
|
3093
|
+
this.apiKeyStamper.setTemporaryPublicKey(publicKey);
|
|
2993
3094
|
}
|
|
2994
3095
|
return publicKey;
|
|
2995
3096
|
}, {
|
|
@@ -3143,6 +3244,76 @@ class TurnkeyClient {
|
|
|
3143
3244
|
// Note: not passing anything here since we want to use the configured stampers and this.config
|
|
3144
3245
|
this.httpClient = this.createHttpClient();
|
|
3145
3246
|
}
|
|
3247
|
+
/**
|
|
3248
|
+
* @beta
|
|
3249
|
+
* **API subject to change**
|
|
3250
|
+
*
|
|
3251
|
+
* Polls Turnkey for the final result of a previously submitted Ethereum transaction.
|
|
3252
|
+
*
|
|
3253
|
+
* This function repeatedly calls `getSendTransactionStatus` until the transaction
|
|
3254
|
+
* reaches a terminal state.
|
|
3255
|
+
*
|
|
3256
|
+
* Terminal states:
|
|
3257
|
+
* - **COMPLETED** or **INCLUDED** → resolves with `{ txHash }`
|
|
3258
|
+
* - **FAILED** rejects with an error
|
|
3259
|
+
*
|
|
3260
|
+
* Behavior:
|
|
3261
|
+
*
|
|
3262
|
+
* - Queries Turnkey every 500ms.
|
|
3263
|
+
* - Stops polling automatically when a terminal state is reached.
|
|
3264
|
+
* - Extracts the canonical on-chain hash via `resp.eth.txHash` when available.
|
|
3265
|
+
*
|
|
3266
|
+
* @param organizationId - Organization ID under which the transaction was submitted.
|
|
3267
|
+
* @param sendTransactionStatusId - Status ID returned by `ethSendTransaction.
|
|
3268
|
+
* @param pollingIntervalMs - Optional polling interval in milliseconds (default: 500ms).
|
|
3269
|
+
*
|
|
3270
|
+
* @returns A promise resolving to `{ txHash?: string }` if successful.
|
|
3271
|
+
* @throws {Error | string} If the transaction fails or is cancelled.
|
|
3272
|
+
*/
|
|
3273
|
+
async pollTransactionStatus(params) {
|
|
3274
|
+
const { organizationId: organizationIdFromParams, stampWith = this.config.defaultStamperType, sendTransactionStatusId, pollingIntervalMs, } = params;
|
|
3275
|
+
const session = await utils.getActiveSessionOrThrowIfRequired(stampWith, this.storageManager.getActiveSession);
|
|
3276
|
+
const organizationId = organizationIdFromParams || session?.organizationId;
|
|
3277
|
+
if (!organizationId) {
|
|
3278
|
+
throw new sdkTypes.TurnkeyError("Organization ID must be provided to fetch user", sdkTypes.TurnkeyErrorCodes.INVALID_REQUEST);
|
|
3279
|
+
}
|
|
3280
|
+
return utils.withTurnkeyErrorHandling(async () => {
|
|
3281
|
+
return new Promise((resolve, reject) => {
|
|
3282
|
+
const interval = pollingIntervalMs ?? 500;
|
|
3283
|
+
const timeoutMs = 60_000; // 1 minute
|
|
3284
|
+
const ref = setInterval(async () => {
|
|
3285
|
+
const resp = await this.httpClient.getSendTransactionStatus({
|
|
3286
|
+
organizationId,
|
|
3287
|
+
sendTransactionStatusId,
|
|
3288
|
+
});
|
|
3289
|
+
const txStatus = resp?.txStatus;
|
|
3290
|
+
const txError = resp?.txError;
|
|
3291
|
+
if (!txStatus)
|
|
3292
|
+
return;
|
|
3293
|
+
if (txError || txStatus === "FAILED" || txStatus === "CANCELLED") {
|
|
3294
|
+
// TODO: use API enum in the future
|
|
3295
|
+
clearInterval(ref);
|
|
3296
|
+
clearTimeout(timeoutRef);
|
|
3297
|
+
reject(txError || `Transaction ${txStatus}`);
|
|
3298
|
+
return;
|
|
3299
|
+
}
|
|
3300
|
+
if (txStatus === "COMPLETED" || txStatus === "INCLUDED") {
|
|
3301
|
+
// TODO: use API enum in the future
|
|
3302
|
+
clearInterval(ref);
|
|
3303
|
+
clearTimeout(timeoutRef);
|
|
3304
|
+
resolve(resp);
|
|
3305
|
+
}
|
|
3306
|
+
}, interval);
|
|
3307
|
+
const timeoutRef = setTimeout(() => {
|
|
3308
|
+
clearInterval(ref);
|
|
3309
|
+
reject(new Error("Polling timed out after 1 minute"));
|
|
3310
|
+
}, timeoutMs);
|
|
3311
|
+
});
|
|
3312
|
+
}, {
|
|
3313
|
+
errorMessage: "Failed to poll transaction status",
|
|
3314
|
+
errorCode: sdkTypes.TurnkeyErrorCodes.POLL_TRANSACTION_STATUS_ERROR,
|
|
3315
|
+
});
|
|
3316
|
+
}
|
|
3146
3317
|
}
|
|
3147
3318
|
|
|
3148
3319
|
exports.TurnkeyClient = TurnkeyClient;
|