SDK Job Management

Manage asynchronous jobs: submit, poll, check status, cancel, and batch operations.

SDK Methods

Method Description Use Case

promptAndWait()

Submit and wait for result Recommended for most cases

prompt()

Submit, return immediately Background processing

pollJob()

Poll until job completes Manual job tracking

getJobStatus()

Check status once Custom polling logic

cancelJob()

Cancel pending/processing job Stop unwanted jobs

Job Lifecycle

pending → processing → completed ↘ failed ↘ cancelled

State Cancellable Description

pending Yes Awaiting processing

processing Yes Actively processing

completed No Finished successfully

failed No Encountered error

cancelled No Cancelled by user

Usage Examples

Recommended: promptAndWait

const result = await client.promptAndWait({ prompt: "Swap 0.1 ETH to USDC", timeout: 60000, });

if (result.status === "completed") { console.log(result.response); }

Manual Job Control

// Submit without waiting const { jobId } = await client.prompt({ prompt: "What are trending tokens?" });

// Check status later const status = await client.getJobStatus(jobId);

// Or poll until complete const result = await client.pollJob({ jobId, timeout: 60000 });

Cancel Job

const { jobId } = await client.prompt({ prompt: "..." }); await client.cancelJob(jobId);

Batch Processing

const prompts = ["Price of ETH", "Price of BTC", "Price of SOL"];

// Submit all in parallel const jobs = await Promise.all( prompts.map(prompt => client.prompt({ prompt })) );

// Wait for all to complete const results = await Promise.all( jobs.map(job => client.pollJob({ jobId: job.jobId })) );

Timing Guidelines

Operation Typical Time Recommended Timeout

Price queries 2-5s 15s

Balance checks 2-5s 15s

Token swaps 5-15s 60s

Cross-chain bridges 10-30s 120s

NFT operations 5-15s 60s

Related Skills

• sdk-wallet-operations: Client setup and configuration

• sdk-capabilities: Full list of supported operations