fix(sdk): expose poll config in InvokeOptions, rename simulation error helper

Author: okekefrancis112

sdk/src/contract/contract.service.spec.ts

@@ -133,7 +133,7 @@ describe('ContractService.invoke()', () => {
     );
     expect(lifecycle.sign).toHaveBeenCalledWith(ASSEMBLED_XDR, Networks.TESTNET);
     expect(lifecycle.submit).toHaveBeenCalledWith(SIGNED_XDR);
-    expect(lifecycle.poll).toHaveBeenCalledWith(TX_HASH);
+    expect(lifecycle.poll).toHaveBeenCalledWith(TX_HASH, undefined);
     expect(result).toEqual({ result: 99, txHash: TX_HASH, ledger: 300 });
   });
 
@@ -171,6 +171,22 @@ describe('ContractService.invoke()', () => {
       expect.objectContaining({ memo: { type: 'text', value: 'raffle-ref' } }),
     );
   });
+
+  it('passes poll config through to lifecycle.poll()', async () => {
+    const { service, lifecycle } = buildService(true);
+
+    jest.spyOn(lifecycle, 'simulate').mockResolvedValue(mockSimulateResult as any);
+    jest.spyOn(lifecycle, 'sign').mockResolvedValue(SIGNED_XDR);
+    jest.spyOn(lifecycle, 'submit').mockResolvedValue(TX_HASH);
+    jest.spyOn(lifecycle, 'poll').mockResolvedValue(mockSubmitResult as any);
+
+    await service.invoke(ContractFn.BUY_TICKET, [1], {
+      sourcePublicKey: SOURCE_KEY,
+      poll: { timeoutMs: 90_000 },
+    });
+
+    expect(lifecycle.poll).toHaveBeenCalledWith(TX_HASH, { timeoutMs: 90_000 });
+  });
 });
 
 describe('ContractService.buildUnsigned()', () => {

sdk/src/contract/contract.service.ts

@@ -17,7 +17,7 @@ import { getRaffleContractId } from './constants';
 import { ContractFnName } from './bindings';
 import { TikkaSdkError, TikkaSdkErrorCode } from '../utils/errors';
 import { TransactionLifecycle } from './lifecycle';
-import type { TxMemo } from './lifecycle';
+import type { TxMemo, PollConfig } from './lifecycle';
 export type { TxMemo } from './lifecycle';
 
 export interface InvokeOptions {
@@ -26,6 +26,8 @@ export interface InvokeOptions {
   fee?: string;
   /** Optional memo attached to the transaction envelope. */
   memo?: TxMemo;
+  /** Optional polling configuration override. */
+  poll?: PollConfig;
 }
 
 export interface InvokeResult<T = any> {
@@ -63,7 +65,7 @@ export interface SubmitSignedResult<T = any> {
  * Detects if an error message indicates a failure in an external contract
  * (e.g., a SEP-41 token contract rejecting a transfer).
  */
-function isExternalContractFailure(errorMsg: string): boolean {
+function isExternalSimulationError(errorMsg: string): boolean {
   return /external|token|sep-?41/i.test(errorMsg);
 }
 
@@ -116,7 +118,7 @@ export class ContractService {
 
     if (rpc.Api.isSimulationError(simResponse)) {
       const errMsg = (simResponse as any).error ?? '';
-      const code = isExternalContractFailure(errMsg)
+      const code = isExternalSimulationError(errMsg)
         ? TikkaSdkErrorCode.ExternalContractError
         : TikkaSdkErrorCode.SimulationFailed;
       throw new TikkaSdkError(
@@ -161,7 +163,7 @@ export class ContractService {
 
     const signedXdr = await this.lifecycle.sign(sim.assembledXdr, sim.networkPassphrase);
     const txHash    = await this.lifecycle.submit(signedXdr);
-    const polled    = await this.lifecycle.poll<T>(txHash);
+    const polled    = await this.lifecycle.poll<T>(txHash, options.poll);
     return { result: polled.returnValue as T, txHash: polled.txHash, ledger: polled.ledger };
   }