@ar.io/sdk 2.3.3-alpha.1 → 2.4.0-alpha.10
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 +282 -9
- package/bundles/web.bundle.min.js +63 -63
- package/lib/cjs/common/ant.js +80 -1
- package/lib/cjs/common/io.js +204 -49
- package/lib/cjs/types/ant.js +11 -1
- package/lib/cjs/utils/arweave.js +5 -1
- package/lib/cjs/version.js +1 -1
- package/lib/esm/common/ant.js +80 -1
- package/lib/esm/common/io.js +202 -47
- package/lib/esm/types/ant.js +10 -0
- package/lib/esm/utils/arweave.js +3 -0
- package/lib/esm/version.js +1 -1
- package/lib/types/common/ant.d.ts +52 -1
- package/lib/types/common/io.d.ts +87 -10
- package/lib/types/types/ant.d.ts +29 -0
- package/lib/types/types/io.d.ts +69 -14
- package/lib/types/utils/arweave.d.ts +7 -0
- 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;
|
|
@@ -114,6 +142,19 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
114
142
|
decreaseDelegateStake(params: {
|
|
115
143
|
target: string;
|
|
116
144
|
decreaseQty: number | mIOToken;
|
|
145
|
+
instant?: boolean;
|
|
146
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
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;
|
|
157
|
+
vaultId: string;
|
|
117
158
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
118
159
|
increaseOperatorStake(params: {
|
|
119
160
|
increaseQty: number | mIOToken;
|
|
@@ -131,6 +172,26 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
131
172
|
type: 'lease' | 'permabuy';
|
|
132
173
|
processId: string;
|
|
133
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
|
+
*/
|
|
134
195
|
extendLease(params: {
|
|
135
196
|
name: string;
|
|
136
197
|
years: number;
|
|
@@ -139,8 +200,24 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
|
|
|
139
200
|
name: string;
|
|
140
201
|
increaseCount: number;
|
|
141
202
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
142
|
-
|
|
143
|
-
|
|
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;
|
|
144
214
|
vaultId: string;
|
|
145
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>;
|
|
146
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>;
|
|
@@ -269,6 +309,11 @@ export interface AoIOWrite extends AoIORead {
|
|
|
269
309
|
decreaseDelegateStake(params: {
|
|
270
310
|
target: WalletAddress;
|
|
271
311
|
decreaseQty: number | mIOToken;
|
|
312
|
+
instant?: boolean;
|
|
313
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
314
|
+
instantWithdrawal(params: {
|
|
315
|
+
gatewayAddress?: WalletAddress;
|
|
316
|
+
vaultId: string;
|
|
272
317
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
273
318
|
saveObservations(params: {
|
|
274
319
|
reportTxId: TransactionId;
|
|
@@ -280,6 +325,9 @@ export interface AoIOWrite extends AoIORead {
|
|
|
280
325
|
type: 'lease' | 'permabuy';
|
|
281
326
|
processId: string;
|
|
282
327
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
328
|
+
upgradeRecord(params: {
|
|
329
|
+
name: string;
|
|
330
|
+
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
283
331
|
extendLease(params: {
|
|
284
332
|
name: string;
|
|
285
333
|
years: number;
|
|
@@ -288,10 +336,17 @@ export interface AoIOWrite extends AoIORead {
|
|
|
288
336
|
name: string;
|
|
289
337
|
increaseCount: number;
|
|
290
338
|
}, options?: WriteOptions): Promise<AoMessageResult>;
|
|
291
|
-
|
|
292
|
-
|
|
339
|
+
cancelWithdrawal(params: {
|
|
340
|
+
gatewayAddress?: WalletAddress;
|
|
293
341
|
vaultId: string;
|
|
294
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>;
|
|
295
350
|
}
|
|
296
351
|
export declare function isProcessConfiguration(config: object): config is {
|
|
297
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
|
+
}[];
|
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.
|
|
3
|
+
"version": "2.4.0-alpha.10",
|
|
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",
|