HttpAgentOptions

Defined in: packages/agent/src/agent/http/index.ts:114

backoffStrategy?

optional backoffStrategy: BackoffStrategyFactory

Defined in: packages/agent/src/agent/http/index.ts:161

The strategy to use for backoff when retrying requests

---

callOptions?

optional callOptions: Record<string, unknown>

Defined in: packages/agent/src/agent/http/index.ts:124

---

credentials?

optional credentials: object

Defined in: packages/agent/src/agent/http/index.ts:140

name

name: string

password?

optional password: string

---

fetch()?

optional fetch: {(input, init?): Promise<Response>; (input, init?): Promise<Response>; }

Defined in: packages/agent/src/agent/http/index.ts:116

Call Signature

(input, init?): Promise<Response>

MDN Reference

Parameters

input

RequestInfo | URL

init?

RequestInit

Returns

Promise<Response>

Call Signature

(input, init?): Promise<Response>

MDN Reference

Parameters

input

string | Request | URL

init?

RequestInit

Returns

Promise<Response>

---

fetchOptions?

optional fetchOptions: Record<string, unknown>

Defined in: packages/agent/src/agent/http/index.ts:121

---

host?

optional host: string

Defined in: packages/agent/src/agent/http/index.ts:128

---

identity?

optional identity: Identity | Promise<Identity>

Defined in: packages/agent/src/agent/http/index.ts:132

---

ingressExpiryInMinutes?

optional ingressExpiryInMinutes: number

Defined in: packages/agent/src/agent/http/index.ts:138

The maximum time a request can be delayed before being rejected.

Default

5 minutes

---

logToConsole?

optional logToConsole: boolean

Defined in: packages/agent/src/agent/http/index.ts:170

Whether to log to the console. Defaults to false.

---

retryTimes?

optional retryTimes: number

Defined in: packages/agent/src/agent/http/index.ts:157

Number of times to retry requests before throwing an error

Default

3

---

rootKey?

optional rootKey: Uint8Array<ArrayBufferLike>

Defined in: packages/agent/src/agent/http/index.ts:175

Alternate root key to use for verifying certificates. If not provided, the default IC root key will be used.

---

shouldFetchRootKey?

optional shouldFetchRootKey: boolean

Defined in: packages/agent/src/agent/http/index.ts:180

Whether or not the root key should be automatically fetched during construction. Defaults to false.

---

shouldSyncTime?

optional shouldSyncTime: boolean

Defined in: packages/agent/src/agent/http/index.ts:185

Whether or not to sync the time with the network during construction. Defaults to false.

---

useQueryNonces?

optional useQueryNonces: boolean

Defined in: packages/agent/src/agent/http/index.ts:152

Adds a unique Nonce with each query. Enabling will prevent queries from being answered with a cached response.

Example

const agent = new HttpAgent({ useQueryNonces: true });
agent.addTransform(makeNonceTransform(makeNonce);

Default

false

---

verifyQuerySignatures?

optional verifyQuerySignatures: boolean

Defined in: packages/agent/src/agent/http/index.ts:166

Whether the agent should verify signatures signed by node keys on query responses. Increases security, but adds overhead and must make a separate request to cache the node keys for the canister’s subnet.

Default

true