@ar.io/sdk 2.4.0-alpha.1 → 2.4.0-alpha.11
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/README.md +250 -11
- package/bundles/web.bundle.min.js +63 -63
- package/lib/cjs/common/ant.js +80 -1
- package/lib/cjs/common/io.js +198 -56
- package/lib/cjs/types/ant.js +11 -1
- package/lib/cjs/utils/arweave.js +5 -1
- package/lib/cjs/utils/processes.js +4 -2
- package/lib/cjs/version.js +1 -1
- package/lib/esm/common/ant.js +80 -1
- package/lib/esm/common/io.js +196 -54
- package/lib/esm/types/ant.js +10 -0
- package/lib/esm/utils/arweave.js +3 -0
- package/lib/esm/utils/processes.js +4 -2
- package/lib/esm/version.js +1 -1
- package/lib/types/common/ant.d.ts +52 -1
- package/lib/types/common/io.d.ts +84 -12
- package/lib/types/types/ant.d.ts +29 -0
- package/lib/types/types/io.d.ts +66 -16
- package/lib/types/utils/arweave.d.ts +7 -0
- package/lib/types/utils/processes.d.ts +3 -1
- package/lib/types/version.d.ts +1 -1
- package/package.json +8 -6
package/lib/types/common/io.d.ts
CHANGED
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
* limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
import Arweave from 'arweave';
|
|
17
|
-
import { AoArNSNameDataWithName, AoArNSReservedNameData, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, ContractSigner, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
|
|
18
|
-
import { AoArNSNameData, AoEpochData, AoEpochSettings, AoGateway, AoIORead, AoIOWrite, AoRegistrationFees, EpochInput } from '../types/io.js';
|
|
17
|
+
import { AoArNSNameDataWithName, AoArNSReservedNameData, AoAuction, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, ContractSigner, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
|
|
18
|
+
import { AoArNSNameData, AoAuctionPriceData, AoEpochData, AoEpochSettings, AoGateway, AoGatewayDelegate, AoIORead, AoIOWrite, AoRegistrationFees, EpochInput } from '../types/io.js';
|
|
19
19
|
import { mIOToken } from '../types/token.js';
|
|
20
20
|
import { AOProcess } from './contracts/ao-process.js';
|
|
21
21
|
export declare class IO {
|
|
@@ -55,7 +55,7 @@ export declare class IOReadable implements AoIORead {
|
|
|
55
55
|
getArNSRecord({ name, }: {
|
|
56
56
|
name: string;
|
|
57
57
|
}): Promise<AoArNSNameData | undefined>;
|
|
58
|
-
getArNSRecords(
|
|
58
|
+
getArNSRecords(params?: PaginationParams<AoArNSNameDataWithName>): Promise<PaginationResult<AoArNSNameDataWithName>>;
|
|
59
59
|
getArNSReservedNames(): Promise<Record<string, AoArNSReservedNameData> | Record<string, never>>;
|
|
60
60
|
getArNSReservedName({ name, }: {
|
|
61
61
|
name: string;
|
|
@@ -63,11 +63,17 @@ export declare class IOReadable implements AoIORead {
|
|
|
63
63
|
getBalance({ address }: {
|
|
64
64
|
address: WalletAddress;
|
|
65
65
|
}): Promise<number>;
|
|
66
|
-
getBalances(
|
|
66
|
+
getBalances(params?: PaginationParams<AoBalanceWithAddress>): Promise<PaginationResult<AoBalanceWithAddress>>;
|
|
67
67
|
getGateway({ address, }: {
|
|
68
68
|
address: WalletAddress;
|
|
69
69
|
}): Promise<AoGateway | undefined>;
|
|
70
|
-
|
|
70
|
+
getGatewayDelegates({ address, ...pageParams }: {
|
|
71
|
+
address: WalletAddress;
|
|
72
|
+
} & PaginationParams<AoGatewayDelegate>): Promise<PaginationResult<AoGatewayDelegate>>;
|
|
73
|
+
getGatewayDelegateAllowList({ address, ...pageParams }: {
|
|
74
|
+
address: WalletAddress;
|
|
75
|
+
} & PaginationParams<WalletAddress>): Promise<PaginationResult<WalletAddress>>;
|
|
76
|
+
getGateways(pageParams?: PaginationParams<AoGatewayWithAddress>): Promise<PaginationResult<AoGatewayWithAddress>>;
|
|
71
77
|
getCurrentEpoch(): Promise<AoEpochData>;
|
|
72
78
|
getPrescribedObservers(epoch?: EpochInput): Promise<AoWeightedObserver[]>;
|
|
73
79
|
getPrescribedNames(epoch?: EpochInput): Promise<string[]>;
|
|
@@ -75,7 +81,7 @@ export declare class IOReadable implements AoIORead {
|
|
|
75
81
|
getDistributions(epoch?: EpochInput): Promise<AoEpochDistributionData>;
|
|
76
82
|
getTokenCost(params: {
|
|
77
83
|
intent: 'Buy-Record';
|
|
78
|
-
|
|
84
|
+
type: 'permabuy' | 'lease';
|
|
79
85
|
years: number;
|
|
80
86
|
name: string;
|
|
81
87
|
}): Promise<number>;
|
|
@@ -91,6 +97,28 @@ export declare class IOReadable implements AoIORead {
|
|
|
91
97
|
}): Promise<number>;
|
|
92
98
|
getRegistrationFees(): Promise<AoRegistrationFees>;
|
|
93
99
|
getDemandFactor(): Promise<number>;
|
|
100
|
+
getArNSAuctions(params?: PaginationParams<AoAuction>): Promise<PaginationResult<AoAuction>>;
|
|
101
|
+
getArNSAuction({ name, }: {
|
|
102
|
+
name: string;
|
|
103
|
+
}): Promise<AoAuction | undefined>;
|
|
104
|
+
/**
|
|
105
|
+
* Get auction prices for a given auction at the provided intervals
|
|
106
|
+
*
|
|
107
|
+
* @param {Object} params - The parameters for fetching auction prices
|
|
108
|
+
* @param {string} params.name - The name of the auction
|
|
109
|
+
* @param {('permabuy'|'lease')} [params.type='lease'] - The type of purchase
|
|
110
|
+
* @param {number} [params.years=1] - The number of years for lease (only applicable if type is 'lease')
|
|
111
|
+
* @param {number} [params.timestamp=Date.now()] - The timestamp to fetch prices for
|
|
112
|
+
* @param {number} [params.intervalMs=900000] - The interval in milliseconds between price points (default is 15 minutes)
|
|
113
|
+
* @returns {Promise<AoAuctionPriceData>} The auction price data
|
|
114
|
+
*/
|
|
115
|
+
getArNSAuctionPrices({ name, type, years, timestamp, intervalMs, }: {
|
|
116
|
+
name: string;
|
|
117
|
+
type?: 'permabuy' | 'lease';
|
|
118
|
+
years?: number;
|
|
119
|
+
timestamp?: number;
|
|
120
|
+
intervalMs?: number;
|
|
121
|
+
}): Promise<AoAuctionPriceData>;
|
|
94
122
|
}
|
|
95
123
|
export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
96
124
|
protected process: AOProcess;
|
|
@@ -104,9 +132,9 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
104
132
|
target: string;
|
|
105
133
|
qty: number | mIOToken;
|
|
106
134
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
107
|
-
joinNetwork({ operatorStake, allowDelegatedStaking, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
135
|
+
joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
108
136
|
leaveNetwork(options?: WriteOptions): Promise<AoMessageResult>;
|
|
109
|
-
updateGatewaySettings({ allowDelegatedStaking, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
137
|
+
updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
110
138
|
delegateStake(params: {
|
|
111
139
|
target: string;
|
|
112
140
|
stakeQty: number | mIOToken;
|
|
@@ -116,8 +144,16 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
116
144
|
decreaseQty: number | mIOToken;
|
|
117
145
|
instant?: boolean;
|
|
118
146
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
119
|
-
|
|
120
|
-
|
|
147
|
+
/**
|
|
148
|
+
* Initiates an instant withdrawal from a gateway.
|
|
149
|
+
*
|
|
150
|
+
* @param {Object} params - The parameters for initiating an instant withdrawal
|
|
151
|
+
* @param {string} params.address - The gateway address of the withdrawal, if not provided, the signer's address will be used
|
|
152
|
+
* @param {string} params.vaultId - The vault ID of the withdrawal
|
|
153
|
+
* @returns {Promise<AoMessageResult>} The result of the withdrawal
|
|
154
|
+
*/
|
|
155
|
+
instantWithdrawal(params: {
|
|
156
|
+
gatewayAddress?: string;
|
|
121
157
|
vaultId: string;
|
|
122
158
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
123
159
|
increaseOperatorStake(params: {
|
|
@@ -136,6 +172,26 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
136
172
|
type: 'lease' | 'permabuy';
|
|
137
173
|
processId: string;
|
|
138
174
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
175
|
+
/**
|
|
176
|
+
* Upgrades an existing leased record to a permabuy.
|
|
177
|
+
*
|
|
178
|
+
* @param {Object} params - The parameters for upgrading a record
|
|
179
|
+
* @param {string} params.name - The name of the record to upgrade
|
|
180
|
+
* @param {Object} [options] - The options for the upgrade
|
|
181
|
+
* @returns {Promise<AoMessageResult>} The result of the upgrade
|
|
182
|
+
*/
|
|
183
|
+
upgradeRecord(params: {
|
|
184
|
+
name: string;
|
|
185
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
186
|
+
/**
|
|
187
|
+
* Extends the lease of an existing leased record.
|
|
188
|
+
*
|
|
189
|
+
* @param {Object} params - The parameters for extending a lease
|
|
190
|
+
* @param {string} params.name - The name of the record to extend
|
|
191
|
+
* @param {number} params.years - The number of years to extend the lease
|
|
192
|
+
* @param {Object} [options] - The options for the extension
|
|
193
|
+
* @returns {Promise<AoMessageResult>} The result of the extension
|
|
194
|
+
*/
|
|
139
195
|
extendLease(params: {
|
|
140
196
|
name: string;
|
|
141
197
|
years: number;
|
|
@@ -144,8 +200,24 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
144
200
|
name: string;
|
|
145
201
|
increaseCount: number;
|
|
146
202
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
147
|
-
|
|
148
|
-
|
|
203
|
+
/**
|
|
204
|
+
* Cancel a withdrawal from a gateway.
|
|
205
|
+
*
|
|
206
|
+
* @param {Object} params - The parameters for cancelling a withdrawal
|
|
207
|
+
* @param {string} [params.address] - The address of the withdrawal (optional). If not provided, the signer's address will be used.
|
|
208
|
+
* @param {string} params.vaultId - The vault ID of the withdrawal.
|
|
209
|
+
* @param {Object} [options] - The options for the cancellation
|
|
210
|
+
* @returns {Promise<AoMessageResult>} The result of the cancellation
|
|
211
|
+
*/
|
|
212
|
+
cancelWithdrawal(params: {
|
|
213
|
+
gatewayAddress?: WalletAddress;
|
|
149
214
|
vaultId: string;
|
|
150
215
|
}, options?: WriteOptions | undefined): Promise<AoMessageResult>;
|
|
216
|
+
submitAuctionBid(params: {
|
|
217
|
+
name: string;
|
|
218
|
+
processId: string;
|
|
219
|
+
quantity?: number;
|
|
220
|
+
type?: 'lease' | 'permabuy';
|
|
221
|
+
years?: number;
|
|
222
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
151
223
|
}
|
package/lib/types/types/ant.d.ts
CHANGED
|
@@ -29,6 +29,8 @@ import { AoMessageResult, WalletAddress, WriteOptions } from './common.js';
|
|
|
29
29
|
*/
|
|
30
30
|
export declare const ArweaveTxIdSchema: z.ZodEffects<z.ZodString, string, string>;
|
|
31
31
|
export declare const IntegerStringSchema: z.ZodEffects<z.ZodString, string, string>;
|
|
32
|
+
export declare const AntDescriptionSchema: z.ZodString;
|
|
33
|
+
export declare const AntKeywordsSchema: z.ZodArray<z.ZodString, "many">;
|
|
32
34
|
export declare const AntRecordSchema: z.ZodObject<{
|
|
33
35
|
transactionId: z.ZodEffects<z.ZodString, string, string>;
|
|
34
36
|
ttlSeconds: z.ZodNumber;
|
|
@@ -55,6 +57,8 @@ export declare const AntBalancesSchema: z.ZodRecord<z.ZodEffects<z.ZodString, st
|
|
|
55
57
|
export declare const AntStateSchema: z.ZodObject<{
|
|
56
58
|
Name: z.ZodString;
|
|
57
59
|
Ticker: z.ZodString;
|
|
60
|
+
Description: z.ZodString;
|
|
61
|
+
Keywords: z.ZodArray<z.ZodString, "many">;
|
|
58
62
|
Denomination: z.ZodNumber;
|
|
59
63
|
Owner: z.ZodEffects<z.ZodString, string, string>;
|
|
60
64
|
Controllers: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
|
|
@@ -77,6 +81,8 @@ export declare const AntStateSchema: z.ZodObject<{
|
|
|
77
81
|
"Source-Code-TX-ID": string;
|
|
78
82
|
Name: string;
|
|
79
83
|
Ticker: string;
|
|
84
|
+
Description: string;
|
|
85
|
+
Keywords: string[];
|
|
80
86
|
Denomination: number;
|
|
81
87
|
Owner: string;
|
|
82
88
|
Controllers: string[];
|
|
@@ -92,6 +98,8 @@ export declare const AntStateSchema: z.ZodObject<{
|
|
|
92
98
|
"Source-Code-TX-ID": string;
|
|
93
99
|
Name: string;
|
|
94
100
|
Ticker: string;
|
|
101
|
+
Description: string;
|
|
102
|
+
Keywords: string[];
|
|
95
103
|
Denomination: number;
|
|
96
104
|
Owner: string;
|
|
97
105
|
Controllers: string[];
|
|
@@ -113,6 +121,8 @@ export declare const AntInfoSchema: z.ZodObject<{
|
|
|
113
121
|
"Source-Code-TX-ID": z.ZodEffects<z.ZodString, string, string>;
|
|
114
122
|
Ticker: z.ZodString;
|
|
115
123
|
"Total-Supply": z.ZodEffects<z.ZodString, string, string>;
|
|
124
|
+
Description: z.ZodString;
|
|
125
|
+
Keywords: z.ZodArray<z.ZodString, "many">;
|
|
116
126
|
Logo: z.ZodEffects<z.ZodString, string, string>;
|
|
117
127
|
Denomination: z.ZodEffects<z.ZodString, string, string>;
|
|
118
128
|
Handlers: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
|
|
@@ -121,6 +131,8 @@ export declare const AntInfoSchema: z.ZodObject<{
|
|
|
121
131
|
"Source-Code-TX-ID": string;
|
|
122
132
|
Name: string;
|
|
123
133
|
Ticker: string;
|
|
134
|
+
Description: string;
|
|
135
|
+
Keywords: string[];
|
|
124
136
|
Denomination: string;
|
|
125
137
|
Owner: string;
|
|
126
138
|
Logo: string;
|
|
@@ -131,6 +143,8 @@ export declare const AntInfoSchema: z.ZodObject<{
|
|
|
131
143
|
"Source-Code-TX-ID": string;
|
|
132
144
|
Name: string;
|
|
133
145
|
Ticker: string;
|
|
146
|
+
Description: string;
|
|
147
|
+
Keywords: string[];
|
|
134
148
|
Denomination: string;
|
|
135
149
|
Owner: string;
|
|
136
150
|
Logo: string;
|
|
@@ -184,7 +198,22 @@ export interface AoANTWrite extends AoANTRead {
|
|
|
184
198
|
setTicker({ ticker }: {
|
|
185
199
|
ticker: string;
|
|
186
200
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
201
|
+
setDescription({ description }: {
|
|
202
|
+
description: string;
|
|
203
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
204
|
+
setKeywords({ keywords }: {
|
|
205
|
+
keywords: string[];
|
|
206
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
187
207
|
setName({ name }: {
|
|
188
208
|
name: string;
|
|
189
209
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
210
|
+
releaseName({ name, ioProcessId }: {
|
|
211
|
+
name: string;
|
|
212
|
+
ioProcessId: string;
|
|
213
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
214
|
+
reassignName({ name, ioProcessId, antProcessId, }: {
|
|
215
|
+
name: string;
|
|
216
|
+
ioProcessId: string;
|
|
217
|
+
antProcessId: string;
|
|
218
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
190
219
|
}
|
package/lib/types/types/io.d.ts
CHANGED
|
@@ -16,17 +16,17 @@
|
|
|
16
16
|
import { AOProcess } from '../common/index.js';
|
|
17
17
|
import { AoMessageResult, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
|
|
18
18
|
import { mIOToken } from './token.js';
|
|
19
|
-
export type PaginationParams = {
|
|
19
|
+
export type PaginationParams<T = Record<string, never>> = {
|
|
20
20
|
cursor?: string;
|
|
21
21
|
limit?: number;
|
|
22
|
-
sortBy?: string;
|
|
22
|
+
sortBy?: keyof T extends never ? string : keyof T;
|
|
23
23
|
sortOrder?: 'asc' | 'desc';
|
|
24
24
|
};
|
|
25
25
|
export type PaginationResult<T> = {
|
|
26
26
|
items: T[];
|
|
27
27
|
nextCursor: string | undefined;
|
|
28
28
|
totalItems: number;
|
|
29
|
-
sortBy
|
|
29
|
+
sortBy?: keyof T;
|
|
30
30
|
sortOrder: 'asc' | 'desc';
|
|
31
31
|
hasMore: boolean;
|
|
32
32
|
};
|
|
@@ -142,10 +142,11 @@ export type AoGatewayService = {
|
|
|
142
142
|
export type AoGatewayServices = {
|
|
143
143
|
bundlers: AoGatewayService[];
|
|
144
144
|
} | undefined;
|
|
145
|
+
export type AoGatewayDelegates = Record<WalletAddress, AoGatewayDelegate>;
|
|
146
|
+
export type AoGatewayDelegateAllowList = WalletAddress[];
|
|
145
147
|
export type AoGateway = {
|
|
146
148
|
settings: AoGatewaySettings;
|
|
147
149
|
stats: AoGatewayStats;
|
|
148
|
-
delegates: Record<WalletAddress, AoGatewayDelegate>;
|
|
149
150
|
totalDelegatedStake: number;
|
|
150
151
|
vaults: Record<WalletAddress, AoVaultData>;
|
|
151
152
|
startTimestamp: Timestamp;
|
|
@@ -188,8 +189,9 @@ export type AoGatewayDelegate = {
|
|
|
188
189
|
vaults: Record<WalletAddress, AoVaultData>;
|
|
189
190
|
};
|
|
190
191
|
export type AoGatewaySettings = {
|
|
191
|
-
allowDelegatedStaking: boolean;
|
|
192
|
+
allowDelegatedStaking: boolean | 'allowlist';
|
|
192
193
|
delegateRewardShareRatio: number;
|
|
194
|
+
allowedDelegates: WalletAddress[];
|
|
193
195
|
minDelegatedStake: number;
|
|
194
196
|
autoStake: boolean;
|
|
195
197
|
label: string;
|
|
@@ -203,6 +205,27 @@ export type AoBalanceWithAddress = {
|
|
|
203
205
|
address: WalletAddress;
|
|
204
206
|
balance: number;
|
|
205
207
|
};
|
|
208
|
+
export type AoAuctionSettings = {
|
|
209
|
+
durationMs: number;
|
|
210
|
+
decayRate: number;
|
|
211
|
+
scalingExponent: number;
|
|
212
|
+
startPriceMultiplier: number;
|
|
213
|
+
};
|
|
214
|
+
export type AoAuction = {
|
|
215
|
+
name: string;
|
|
216
|
+
startTimestamp: Timestamp;
|
|
217
|
+
endTimestamp: Timestamp;
|
|
218
|
+
initiator: string;
|
|
219
|
+
baseFee: number;
|
|
220
|
+
demandFactor: number;
|
|
221
|
+
settings: AoAuctionSettings;
|
|
222
|
+
};
|
|
223
|
+
export type AoAuctionPriceData = {
|
|
224
|
+
type: 'lease' | 'permabuy';
|
|
225
|
+
years?: number;
|
|
226
|
+
prices: Record<string, number>;
|
|
227
|
+
currentPrice: number;
|
|
228
|
+
};
|
|
206
229
|
export type AoJoinNetworkParams = Pick<AoGateway, 'operatorStake' | 'observerAddress'> & Partial<AoGatewaySettings>;
|
|
207
230
|
export type AoUpdateGatewaySettingsParams = AtLeastOne<AoJoinNetworkParams>;
|
|
208
231
|
export interface AoIORead {
|
|
@@ -219,28 +242,45 @@ export interface AoIORead {
|
|
|
219
242
|
getGateway({ address, }: {
|
|
220
243
|
address: WalletAddress;
|
|
221
244
|
}): Promise<AoGateway | undefined>;
|
|
222
|
-
|
|
245
|
+
getGatewayDelegates(params: {
|
|
246
|
+
address: WalletAddress;
|
|
247
|
+
} & PaginationParams<AoGatewayDelegate>): Promise<PaginationResult<AoGatewayDelegate>>;
|
|
248
|
+
getGatewayDelegateAllowList(params?: PaginationParams<WalletAddress> & {
|
|
249
|
+
address: WalletAddress;
|
|
250
|
+
}): Promise<PaginationResult<WalletAddress>>;
|
|
251
|
+
getGateways(params?: PaginationParams<AoGatewayWithAddress>): Promise<PaginationResult<AoGatewayWithAddress>>;
|
|
223
252
|
getBalance(params: {
|
|
224
253
|
address: WalletAddress;
|
|
225
254
|
}): Promise<number>;
|
|
226
|
-
getBalances(params?: PaginationParams): Promise<PaginationResult<AoBalanceWithAddress>>;
|
|
255
|
+
getBalances(params?: PaginationParams<AoBalanceWithAddress>): Promise<PaginationResult<AoBalanceWithAddress>>;
|
|
227
256
|
getArNSRecord({ name, }: {
|
|
228
257
|
name: string;
|
|
229
258
|
}): Promise<AoArNSNameData | undefined>;
|
|
230
|
-
getArNSRecords(params?: PaginationParams): Promise<PaginationResult<AoArNSNameDataWithName>>;
|
|
259
|
+
getArNSRecords(params?: PaginationParams<AoArNSNameDataWithName>): Promise<PaginationResult<AoArNSNameDataWithName>>;
|
|
231
260
|
getArNSReservedNames(): Promise<Record<string, AoArNSReservedNameData> | Record<string, never>>;
|
|
232
261
|
getArNSReservedName({ name, }: {
|
|
233
262
|
name: string;
|
|
234
263
|
}): Promise<AoArNSReservedNameData | undefined>;
|
|
264
|
+
getArNSAuctions(params?: PaginationParams<AoAuction>): Promise<PaginationResult<AoAuction>>;
|
|
265
|
+
getArNSAuction({ name }: {
|
|
266
|
+
name: string;
|
|
267
|
+
}): Promise<AoAuction | undefined>;
|
|
268
|
+
getArNSAuctionPrices({ name, type, years, timestamp, intervalMs, }: {
|
|
269
|
+
name: string;
|
|
270
|
+
type: 'lease' | 'permabuy';
|
|
271
|
+
years?: number;
|
|
272
|
+
timestamp?: number;
|
|
273
|
+
intervalMs?: number;
|
|
274
|
+
}): Promise<AoAuctionPriceData>;
|
|
235
275
|
getEpoch(epoch?: EpochInput): Promise<AoEpochData>;
|
|
236
276
|
getCurrentEpoch(): Promise<AoEpochData>;
|
|
237
277
|
getPrescribedObservers(epoch?: EpochInput): Promise<AoWeightedObserver[]>;
|
|
238
278
|
getPrescribedNames(epoch?: EpochInput): Promise<string[]>;
|
|
239
279
|
getObservations(epoch?: EpochInput): Promise<AoEpochObservationData>;
|
|
240
280
|
getDistributions(epoch?: EpochInput): Promise<AoEpochDistributionData>;
|
|
241
|
-
getTokenCost({ intent,
|
|
281
|
+
getTokenCost({ intent, type, years, name, quantity, }: {
|
|
242
282
|
intent: 'Buy-Record' | 'Extend-Lease' | 'Increase-Undername-Limit';
|
|
243
|
-
|
|
283
|
+
type?: 'permabuy' | 'lease';
|
|
244
284
|
years?: number;
|
|
245
285
|
name?: string;
|
|
246
286
|
quantity?: number;
|
|
@@ -253,9 +293,9 @@ export interface AoIOWrite extends AoIORead {
|
|
|
253
293
|
target: WalletAddress;
|
|
254
294
|
qty: number;
|
|
255
295
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
256
|
-
joinNetwork(
|
|
296
|
+
joinNetwork(params: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
257
297
|
leaveNetwork(options?: WriteOptions): Promise<AoMessageResult>;
|
|
258
|
-
updateGatewaySettings(
|
|
298
|
+
updateGatewaySettings(params: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
|
|
259
299
|
increaseOperatorStake(params: {
|
|
260
300
|
increaseQty: number | mIOToken;
|
|
261
301
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
@@ -271,8 +311,8 @@ export interface AoIOWrite extends AoIORead {
|
|
|
271
311
|
decreaseQty: number | mIOToken;
|
|
272
312
|
instant?: boolean;
|
|
273
313
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
274
|
-
|
|
275
|
-
|
|
314
|
+
instantWithdrawal(params: {
|
|
315
|
+
gatewayAddress?: WalletAddress;
|
|
276
316
|
vaultId: string;
|
|
277
317
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
278
318
|
saveObservations(params: {
|
|
@@ -285,6 +325,9 @@ export interface AoIOWrite extends AoIORead {
|
|
|
285
325
|
type: 'lease' | 'permabuy';
|
|
286
326
|
processId: string;
|
|
287
327
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
328
|
+
upgradeRecord(params: {
|
|
329
|
+
name: string;
|
|
330
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
288
331
|
extendLease(params: {
|
|
289
332
|
name: string;
|
|
290
333
|
years: number;
|
|
@@ -293,10 +336,17 @@ export interface AoIOWrite extends AoIORead {
|
|
|
293
336
|
name: string;
|
|
294
337
|
increaseCount: number;
|
|
295
338
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
296
|
-
|
|
297
|
-
|
|
339
|
+
cancelWithdrawal(params: {
|
|
340
|
+
gatewayAddress?: WalletAddress;
|
|
298
341
|
vaultId: string;
|
|
299
342
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
343
|
+
submitAuctionBid(params: {
|
|
344
|
+
name: string;
|
|
345
|
+
processId: string;
|
|
346
|
+
quantity?: number;
|
|
347
|
+
type?: 'lease' | 'permabuy';
|
|
348
|
+
years?: number;
|
|
349
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
300
350
|
}
|
|
301
351
|
export declare function isProcessConfiguration(config: object): config is {
|
|
302
352
|
process: AOProcess;
|
|
@@ -1,3 +1,10 @@
|
|
|
1
1
|
import { BlockHeight } from '../types/common.js';
|
|
2
2
|
export declare const validateArweaveId: (id: string) => boolean;
|
|
3
3
|
export declare function isBlockHeight(height: string | number): height is BlockHeight;
|
|
4
|
+
export declare const pruneTags: (tags: {
|
|
5
|
+
name: string;
|
|
6
|
+
value: string | undefined;
|
|
7
|
+
}[]) => {
|
|
8
|
+
name: string;
|
|
9
|
+
value: string;
|
|
10
|
+
}[];
|
|
@@ -29,11 +29,13 @@ export declare class ArNSEventEmitter extends EventEmitter {
|
|
|
29
29
|
private timeoutMs;
|
|
30
30
|
private throttle;
|
|
31
31
|
private logger;
|
|
32
|
-
|
|
32
|
+
private strict;
|
|
33
|
+
constructor({ contract, timeoutMs, concurrency, logger, strict, }?: {
|
|
33
34
|
contract?: AoIORead;
|
|
34
35
|
timeoutMs?: number;
|
|
35
36
|
concurrency?: number;
|
|
36
37
|
logger?: ILogger;
|
|
38
|
+
strict?: boolean;
|
|
37
39
|
});
|
|
38
40
|
fetchProcessesOwnedByWallet({ address, pageSize, antRegistry, }: {
|
|
39
41
|
address: WalletAddress;
|
package/lib/types/version.d.ts
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ar.io/sdk",
|
|
3
|
-
"version": "2.4.0-alpha.
|
|
3
|
+
"version": "2.4.0-alpha.11",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "git+https://github.com/ar-io/ar-io-sdk.git"
|
|
@@ -66,16 +66,18 @@
|
|
|
66
66
|
"format": "prettier --check .",
|
|
67
67
|
"format:fix": "prettier --write .",
|
|
68
68
|
"test": "yarn test:unit && yarn test:e2e",
|
|
69
|
-
"test:cjs": "yarn
|
|
70
|
-
"test:esm": "yarn
|
|
71
|
-
"test:web": "yarn
|
|
69
|
+
"test:cjs": "yarn build:cjs && yarn link && cd ./tests/e2e/cjs && yarn && yarn test",
|
|
70
|
+
"test:esm": "yarn build:esm && yarn link && cd ./tests/e2e/esm && yarn && yarn test",
|
|
71
|
+
"test:web": "yarn build:esm && yarn link && cd ./tests/e2e/web && yarn && yarn test",
|
|
72
72
|
"test:unit": "NODE_OPTIONS=\"--import=./register.mjs\" node --test tests/unit/**.test.ts",
|
|
73
73
|
"test:link": "yarn build && yarn link",
|
|
74
74
|
"test:e2e": "yarn test:cjs && yarn test:esm && yarn test:web",
|
|
75
75
|
"prepare": "husky install",
|
|
76
|
+
"docs:update": "markdown-toc-gen insert README.md",
|
|
76
77
|
"example:esm": "cd examples/esm && yarn && node index.mjs",
|
|
77
|
-
"example:cjs": "yarn
|
|
78
|
-
"example:web": "yarn
|
|
78
|
+
"example:cjs": "yarn build:cjs && yarn link && cd examples/cjs && yarn && node index.cjs",
|
|
79
|
+
"example:web": "yarn build:web && http-server --port 8080 --host -o examples/web",
|
|
80
|
+
"example:vite": "yarn build:esm && yarn link && cd examples/vite && yarn && yarn start"
|
|
79
81
|
},
|
|
80
82
|
"devDependencies": {
|
|
81
83
|
"@commitlint/cli": "^17.1.2",
|