@mysten/docs 0.1.18 → 0.1.19
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/dist/bcs/index.md +1 -1
- package/dist/bcs/llms-index.md +1 -1
- package/dist/codegen/index.md +53 -53
- package/dist/codegen/llms-index.md +1 -1
- package/dist/dapp-kit/actions/connect-wallet.md +4 -4
- package/dist/dapp-kit/actions/disconnect-wallet.md +8 -7
- package/dist/dapp-kit/actions/sign-and-execute-transaction.md +14 -14
- package/dist/dapp-kit/actions/sign-personal-message.md +8 -8
- package/dist/dapp-kit/actions/sign-transaction.md +7 -7
- package/dist/dapp-kit/actions/switch-account.md +6 -6
- package/dist/dapp-kit/actions/switch-network.md +5 -5
- package/dist/dapp-kit/dapp-kit-instance.md +19 -18
- package/dist/dapp-kit/getting-started/create-dapp.md +12 -12
- package/dist/dapp-kit/getting-started/next-js.md +12 -11
- package/dist/dapp-kit/getting-started/react.md +25 -25
- package/dist/dapp-kit/getting-started/vue.md +12 -12
- package/dist/dapp-kit/index.md +4 -4
- package/dist/dapp-kit/llms-index.md +23 -23
- package/dist/dapp-kit/react/components/connect-button.md +3 -3
- package/dist/dapp-kit/react/components/connect-modal.md +3 -3
- package/dist/dapp-kit/react/components/index.md +2 -2
- package/dist/dapp-kit/react/dapp-kit-provider.md +6 -6
- package/dist/dapp-kit/react/hooks/index.md +4 -3
- package/dist/dapp-kit/react/hooks/use-current-account.md +3 -3
- package/dist/dapp-kit/react/hooks/use-current-client.md +3 -3
- package/dist/dapp-kit/react/hooks/use-current-network.md +3 -3
- package/dist/dapp-kit/react/hooks/use-current-wallet.md +3 -3
- package/dist/dapp-kit/react/hooks/use-dapp-kit.md +5 -5
- package/dist/dapp-kit/react/hooks/use-wallet-connection.md +3 -3
- package/dist/dapp-kit/react/hooks/use-wallets.md +3 -3
- package/dist/dapp-kit/state.md +16 -16
- package/dist/dapp-kit/theming.md +27 -27
- package/dist/dapp-kit/web-components/connect-button.md +9 -9
- package/dist/dapp-kit/web-components/connect-modal.md +16 -16
- package/dist/kiosk/advanced-examples.md +1 -1
- package/dist/kiosk/from-v1.md +1 -1
- package/dist/kiosk/index.md +5 -5
- package/dist/kiosk/kiosk-client/introduction.md +6 -6
- package/dist/kiosk/kiosk-client/kiosk-transaction/examples.md +3 -3
- package/dist/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction.md +1 -1
- package/dist/kiosk/kiosk-client/kiosk-transaction/managing.md +11 -11
- package/dist/kiosk/kiosk-client/kiosk-transaction/purchasing.md +1 -1
- package/dist/kiosk/kiosk-client/querying.md +1 -1
- package/dist/kiosk/kiosk-client/transfer-policy-transaction/introduction.md +1 -1
- package/dist/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager.md +1 -3
- package/dist/kiosk/llms-index.md +5 -5
- package/dist/llms-index.md +83 -83
- package/dist/payment-kit/getting-started.md +13 -13
- package/dist/payment-kit/index.md +13 -13
- package/dist/payment-kit/llms-index.md +5 -5
- package/dist/payment-kit/payment-kit-sdk.md +18 -18
- package/dist/payment-kit/payment-processing.md +34 -34
- package/dist/payment-kit/registry-management.md +35 -35
- package/dist/seal/index.md +5 -5
- package/dist/seal/llms-index.md +1 -1
- package/dist/slush-wallet/dapp.md +10 -10
- package/dist/slush-wallet/deep-linking.md +54 -54
- package/dist/slush-wallet/index.md +2 -2
- package/dist/slush-wallet/llms-index.md +3 -3
- package/dist/sui/bcs.md +11 -11
- package/dist/sui/clients/core.md +57 -56
- package/dist/sui/clients/graphql.md +3 -3
- package/dist/sui/clients/grpc.md +10 -10
- package/dist/sui/clients/index.md +14 -14
- package/dist/sui/clients/json-rpc.md +16 -16
- package/dist/sui/cryptography/keypairs.md +6 -6
- package/dist/sui/cryptography/multisig.md +4 -4
- package/dist/sui/cryptography/passkey.md +15 -14
- package/dist/sui/cryptography/webcrypto-signer.md +4 -4
- package/dist/sui/executors.md +18 -16
- package/dist/sui/faucet.md +3 -3
- package/dist/sui/hello-sui.md +5 -5
- package/dist/sui/index.md +12 -12
- package/dist/sui/install.md +3 -3
- package/dist/sui/llm-docs.md +9 -9
- package/dist/sui/llms-index.md +41 -41
- package/dist/sui/migrations/0.38.md +6 -6
- package/dist/sui/migrations/sui-1.0.md +32 -32
- package/dist/sui/migrations/sui-2.0/agent-prompt.md +3 -3
- package/dist/sui/migrations/sui-2.0/dapp-kit.md +43 -43
- package/dist/sui/migrations/sui-2.0/deepbook-v3.md +1 -1
- package/dist/sui/migrations/sui-2.0/index.md +37 -37
- package/dist/sui/migrations/sui-2.0/json-rpc-migration.md +53 -47
- package/dist/sui/migrations/sui-2.0/kiosk.md +8 -8
- package/dist/sui/migrations/sui-2.0/sdk-maintainers.md +7 -7
- package/dist/sui/migrations/sui-2.0/seal.md +1 -1
- package/dist/sui/migrations/sui-2.0/sui.md +16 -16
- package/dist/sui/migrations/sui-2.0/suins.md +4 -3
- package/dist/sui/migrations/sui-2.0/wallet-builders.md +5 -5
- package/dist/sui/migrations/sui-2.0/walrus.md +3 -3
- package/dist/sui/migrations/sui-2.0/zksend.md +5 -5
- package/dist/sui/plugins.md +14 -14
- package/dist/sui/sdk-building.md +32 -32
- package/dist/sui/transaction-building/basics.md +13 -13
- package/dist/sui/transaction-building/gas.md +2 -3
- package/dist/sui/transaction-building/intents.md +4 -4
- package/dist/sui/transaction-building/offline.md +8 -8
- package/dist/sui/transaction-building/sponsored-transactions.md +1 -1
- package/dist/sui/utils/derived_objects.md +10 -10
- package/dist/sui/utils/index.md +1 -1
- package/dist/sui/zklogin.md +1 -1
- package/dist/walrus/index.md +1 -1
- package/dist/walrus/llms-index.md +1 -1
- package/dist/zksend/index.md +2 -2
- package/dist/zksend/link-builder.md +5 -4
- package/dist/zksend/llms-index.md +2 -2
- package/package.json +6 -6
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Passkey
|
|
2
2
|
|
|
3
|
-
> Use WebAuthn passkeys for Sui transaction signing
|
|
3
|
+
> Use WebAuthn passkeys for Sui transaction signing.
|
|
4
4
|
|
|
5
5
|
Similar to other Keypair classes, the Sui TypeScript SDK provides the `PasskeyKeypair` that handles
|
|
6
6
|
communication with the passkey device and signing with it. This SDK defines the address and
|
|
@@ -19,8 +19,8 @@ To use, import the `PasskeyKeypair` class from `@mysten/sui/keypairs/passkey`.
|
|
|
19
19
|
## Create a new passkey
|
|
20
20
|
|
|
21
21
|
To create a new passkey with the passkey device, and initialize a `PasskeyKeypair`, you can use the
|
|
22
|
-
`PasskeyProvider` and provide the `rpName`, `rpId
|
|
23
|
-
|
|
22
|
+
`PasskeyProvider` and provide the `rpName`, `rpId`, and additional options. The `getPasskeyInstance`
|
|
23
|
+
call initializes a new passkey wallet for the origin.
|
|
24
24
|
|
|
25
25
|
```typescript
|
|
26
26
|
const keypair = await PasskeyKeypair.getPasskeyInstance(
|
|
@@ -49,15 +49,15 @@ same instance and the public key is available when constructing the passkey sign
|
|
|
49
49
|
It is recommended that the user should only be allowed to create a passkey wallet once per origin.
|
|
50
50
|
If the user ended up with multiple passkeys for the same origin, the passkey UI would show a list of
|
|
51
51
|
all passkeys of the same origin and the user can choose which one to use. This can be a confusing
|
|
52
|
-
experience
|
|
52
|
+
experience because they do not remember which passkey is the way that the wallet was created for.
|
|
53
53
|
|
|
54
54
|
## Recover a passkey
|
|
55
55
|
|
|
56
56
|
However, if the user is logged out or uses a different browser or device, or the `PasskeyKeypair`
|
|
57
|
-
instance is no longer present for any reason, the user should be
|
|
58
|
-
(
|
|
59
|
-
is prompted to create a new key in passkey device, a fresh new wallet with
|
|
60
|
-
created.
|
|
57
|
+
instance is no longer present for any reason, the user should be prompted to recover the public key
|
|
58
|
+
(for example, through a "Log in to existing passkey wallet" flow) to be able to use the passkey
|
|
59
|
+
wallet again. If the user is prompted to create a new key in passkey device, a fresh new wallet with
|
|
60
|
+
new address will be created.
|
|
61
61
|
|
|
62
62
|
One can recover the unique public key with exactly two passkey signatures on two messages. This
|
|
63
63
|
means that if the user is asked to sign two messages, the developer can recover an unique public key
|
|
@@ -80,15 +80,16 @@ const keypair = new PasskeyKeypair(commonPk.toRawBytes(), provider);
|
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
Alternatively, the developer can choose to ask the user to only sign one personal message that
|
|
83
|
-
returns two possible public keys. Then the frontend
|
|
84
|
-
onchain for the unique address that contains assets. Or the frontend
|
|
85
|
-
signatures from past transaction history for the given address. This
|
|
86
|
-
|
|
83
|
+
returns two possible public keys. Then the frontend might derive the addresses for both and check
|
|
84
|
+
onchain for the unique address that contains assets. Or the frontend might retrieve additional
|
|
85
|
+
signatures from past transaction history for the given address. This might be a preferred user
|
|
86
|
+
experience because the user is only prompted to sign one message, but the frontend needs to do extra
|
|
87
|
+
work.
|
|
87
88
|
|
|
88
89
|
## Usage
|
|
89
90
|
|
|
90
91
|
The usage for a passkey keypair is the same as any other keypair. You can derive the public key,
|
|
91
|
-
derive the address, sign personal messages, sign transactions and verify signatures. See the
|
|
92
|
+
derive the address, sign personal messages, sign transactions, and verify signatures. See the
|
|
92
93
|
[Key pairs](./keypairs) documentation for more details.
|
|
93
94
|
|
|
94
95
|
```typescript
|
|
@@ -103,7 +104,7 @@ const txSignature = await passkey.signTransaction(txBytes);
|
|
|
103
104
|
|
|
104
105
|
An example implemention can be found [here](https://github.com/MystenLabs/passkey-example).
|
|
105
106
|
|
|
106
|
-
## Supported
|
|
107
|
+
## Supported platforms
|
|
107
108
|
|
|
108
109
|
Sui supports passkey wallets on any device that complies with the WebAuthn standard. This includes
|
|
109
110
|
most modern browsers and operating systems across desktop and mobile. To check which platforms and
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Web Crypto Signer
|
|
2
2
|
|
|
3
|
-
> Sign transactions using the Web Crypto API
|
|
3
|
+
> Sign transactions using the Web Crypto API for secure browser-based key management.
|
|
4
4
|
|
|
5
|
-
For cases where you need to create keypairs directly within client
|
|
6
|
-
|
|
5
|
+
For cases where you need to create keypairs directly within client apps, you can use the Web Crypto
|
|
6
|
+
Signer. This signer leverages the
|
|
7
7
|
[Web Crypto API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API) to provide a
|
|
8
8
|
secure and efficient way to generate and manage cryptographic keys in the browser. The generated
|
|
9
9
|
keys are `Secp256r1` keys which can be persisted between sessions, and are not extractable by
|
|
@@ -68,7 +68,7 @@ const keypair = await WebCryptoSigner.import(exported);
|
|
|
68
68
|
## Usage
|
|
69
69
|
|
|
70
70
|
The usage for a Web Crypto signer is the same as any other keypair. You can derive the public key,
|
|
71
|
-
derive the address, sign personal messages, sign transactions and verify signatures. See the
|
|
71
|
+
derive the address, sign personal messages, sign transactions, and verify signatures. See the
|
|
72
72
|
[Key pairs](./keypairs) documentation for more details.
|
|
73
73
|
|
|
74
74
|
```typescript
|
package/dist/sui/executors.md
CHANGED
|
@@ -1,15 +1,16 @@
|
|
|
1
1
|
# Transaction Executors
|
|
2
2
|
|
|
3
|
-
> Manage transaction execution with queuing and parallel strategies
|
|
3
|
+
> Manage transaction execution with queuing and parallel strategies.
|
|
4
4
|
|
|
5
|
-
The
|
|
6
|
-
executing multiple transactions signed by the same address. These executors help manage
|
|
7
|
-
versions and gas coins which significantly reduces the number of requests made to RPC nodes,
|
|
8
|
-
many cases avoids the need to wait for the RPC nodes to index previously executed
|
|
5
|
+
The TypeScript SDK ships two `Transaction` executor classes that simplify the processes of
|
|
6
|
+
efficiently executing multiple transactions signed by the same address. These executors help manage
|
|
7
|
+
object versions and gas coins which significantly reduces the number of requests made to RPC nodes,
|
|
8
|
+
and for many cases avoids the need to wait for the RPC nodes to index previously executed
|
|
9
|
+
transactions.
|
|
9
10
|
|
|
10
11
|
## `SerialTransactionExecutor`
|
|
11
12
|
|
|
12
|
-
The `SerialTransactionExecutor` is designed for use in wallet implementations
|
|
13
|
+
The `SerialTransactionExecutor` is designed for use in wallet implementations and apps where the
|
|
13
14
|
objects owned by the address executing transactions are unlikely to be changed by transactions not
|
|
14
15
|
executed through the executor.
|
|
15
16
|
|
|
@@ -61,7 +62,7 @@ const [{ digest: digest1 }, { digest: digest2 }] = await Promise.all([
|
|
|
61
62
|
|
|
62
63
|
## `ParallelTransactionExecutor`
|
|
63
64
|
|
|
64
|
-
> **Warning:** `ParallelTransactionExecutor` is experimental and
|
|
65
|
+
> **Warning:** `ParallelTransactionExecutor` is experimental and might change rapidly as it is being developed.
|
|
65
66
|
|
|
66
67
|
The `ParallelTransactionExecutor` class works similarly to the `SerialTransactionExecutor`, but
|
|
67
68
|
allows for parallel execution of transactions. To make this work, the `ParallelTransactionExecutor`
|
|
@@ -69,8 +70,8 @@ will maintain a pool of gas coins, and automatically execute additional transact
|
|
|
69
70
|
gas pool as needed.
|
|
70
71
|
|
|
71
72
|
> **Warning:** Using other client methods or wallets to execute additional transactions while
|
|
72
|
-
> `ParallelTransactionExecutor` is in use
|
|
73
|
-
> transactions to fail. This
|
|
73
|
+
> `ParallelTransactionExecutor` is in use might consume or combine gas coins in the gasPool, causing
|
|
74
|
+
> transactions to fail. This might also result in the coins becoming locked for the remainder of the
|
|
74
75
|
> current epoch, preventing them from being used in future transactions.
|
|
75
76
|
>
|
|
76
77
|
> Running multiple instances of `ParallelTransactionExecutor` using the same `sourceCoins` will
|
|
@@ -99,9 +100,10 @@ way that avoids conflicts between transactions using the same object ids.
|
|
|
99
100
|
maximum number of concurrent transactions (default 50),
|
|
100
101
|
- `sourceCoins`: An array of coins to use to create the gas pool, defaults to using all coins owned
|
|
101
102
|
by the signer.
|
|
102
|
-
- `epochBoundaryWindow
|
|
103
|
-
gas pool (in milliseconds). Building transactions will be paused for up to 2x this duration
|
|
104
|
-
each epoch boundary to ensure the gas price is up-to-date for the next epoch. (default
|
|
103
|
+
- `epochBoundaryWindow`: Time to wait before or after the expected epoch boundary before re-fetching
|
|
104
|
+
the gas pool (in milliseconds). Building transactions will be paused for up to 2x this duration
|
|
105
|
+
around each epoch boundary to ensure the gas price is up-to-date for the next epoch. (default
|
|
106
|
+
`1000`)
|
|
105
107
|
|
|
106
108
|
```ts
|
|
107
109
|
|
|
@@ -125,23 +127,23 @@ const [{ digest: digest1 }, { digest: digest2 }] = await Promise.all([
|
|
|
125
127
|
]);
|
|
126
128
|
```
|
|
127
129
|
|
|
128
|
-
## Building and
|
|
130
|
+
## Building and executing transactions with executors
|
|
129
131
|
|
|
130
132
|
The executor classes will significantly improve efficiency when executing multiple transactions, but
|
|
131
133
|
to get the best results there are some best practices to follow:
|
|
132
134
|
|
|
133
135
|
When building transactions, always prefer using unresolved object IDs rather than specifying the
|
|
134
|
-
full `id
|
|
136
|
+
full `id`, `version`, and `digest` for an object input (for example, use `tx.object(id)` rather than
|
|
135
137
|
`tx.objectRef({ objectId, version, digest })`). By doing this, you allow the executor to use object
|
|
136
138
|
versions and digests from the cache, and will avoid executing transactions using stale object
|
|
137
139
|
versions.
|
|
138
140
|
|
|
139
|
-
If the signer executes transactions that are not sent through the executor that
|
|
141
|
+
If the signer executes transactions that are not sent through the executor, that might cause
|
|
140
142
|
transactions to fail. The executor classes will handle this by invalidating the cache for any
|
|
141
143
|
objects used in the transaction, so you will often be able to recover by re-trying a failed
|
|
142
144
|
transaction once. If it was caused by a stale cache, it should succeed on the second execution.
|
|
143
145
|
|
|
144
|
-
> **Warning:** Transaction plugins and intents
|
|
146
|
+
> **Warning:** Transaction plugins and intents might resolve their own data (such as object references) that are
|
|
145
147
|
> not automatically managed by the executor's object cache. This can cause transactions to include
|
|
146
148
|
> stale object versions. The `coinWithBalance` intent is partially supported by the executors and
|
|
147
149
|
> will work correctly when all coin types are either SUI or the required balances are available as
|
package/dist/sui/faucet.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Faucet
|
|
2
2
|
|
|
3
|
-
> Request test SUI tokens from the faucet
|
|
3
|
+
> Request test SUI tokens from the faucet on Devnet, Testnet, or local networks.
|
|
4
4
|
|
|
5
5
|
Devnet, Testnet, and local networks include faucets that mint SUI. You can use the Sui TypeScript
|
|
6
6
|
SDK to call a network's faucet and provide SUI to the address you provide.
|
|
@@ -22,5 +22,5 @@ await requestSuiFromFaucetV2({
|
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
> **Note:** Faucets on Devnet and Testnet are rate limited. If you run the script too many times, you surpass
|
|
25
|
-
> the limit and must wait to successfully run it again. For
|
|
26
|
-
> the Web UI: `faucet.sui.io`.
|
|
25
|
+
> the limit and must wait to successfully run it again. For Testnet, the best way to get SUI is
|
|
26
|
+
> through the Web UI: `faucet.sui.io`.
|
package/dist/sui/hello-sui.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Hello Sui
|
|
2
2
|
|
|
3
|
-
> Build your first Sui application with the TypeScript SDK
|
|
3
|
+
> Build your first Sui application with the TypeScript SDK.
|
|
4
4
|
|
|
5
5
|
This basic example introduces you to the Sui TypeScript SDK. The Node.js example mints SUI on a Sui
|
|
6
6
|
network and then queries the address to get a sum for the owned SUI. You don't need to use an IDE to
|
|
@@ -9,8 +9,8 @@ projects.
|
|
|
9
9
|
|
|
10
10
|
## Before you begin
|
|
11
11
|
|
|
12
|
-
You need an address on a Sui development network (Devnet, Testnet, local). If you don't already
|
|
13
|
-
an address, use the [Sui Client CLI](https://docs.sui.io/references/cli/client) or the
|
|
12
|
+
You need an address on a Sui development network (Devnet, Testnet, or local). If you don't already
|
|
13
|
+
have an address, use the [Sui Client CLI](https://docs.sui.io/references/cli/client) or the
|
|
14
14
|
[Sui Wallet browser extension](https://docs.mystenlabs.com) to create one.
|
|
15
15
|
|
|
16
16
|
You also need [Node.js](https://nodejs.org/en/download/current) and a package manager like
|
|
@@ -108,8 +108,8 @@ using the faucet. You can check the total SUI for your address using the Sui Wal
|
|
|
108
108
|
CLI.
|
|
109
109
|
|
|
110
110
|
> **Note:** Faucets on Devnet and Testnet are rate limited. If you run the script too many times, you surpass
|
|
111
|
-
> the limit and must wait to successfully run it again. For
|
|
112
|
-
> the Web UI: `faucet.sui.io`.
|
|
111
|
+
> the limit and must wait to successfully run it again. For Testnet, the best way to get SUI is
|
|
112
|
+
> through the Web UI: `faucet.sui.io`.
|
|
113
113
|
|
|
114
114
|
You can also use the [Sui Client CLI](https://docs.sui.io/references/cli/client) to perform client
|
|
115
115
|
calls on a Sui network.
|
package/dist/sui/index.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Sui TypeScript SDK Quick Start
|
|
2
2
|
|
|
3
|
-
> TypeScript SDK for
|
|
3
|
+
> The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain.
|
|
4
4
|
|
|
5
5
|
The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain. Use it
|
|
6
6
|
to send queries to RPC nodes, build and sign transactions, and interact with a Sui or local network.
|
|
@@ -16,7 +16,7 @@ npm i @mysten/sui
|
|
|
16
16
|
The following table lists the locations for Sui networks.
|
|
17
17
|
|
|
18
18
|
| Network | Full node | faucet |
|
|
19
|
-
|
|
|
19
|
+
| :------ | :------------------------------------ | :--------------------------------------- |
|
|
20
20
|
| local | `http://127.0.0.1:9000` (default) | `http://127.0.0.1:9123/v2/gas` (default) |
|
|
21
21
|
| Devnet | `https://fullnode.devnet.sui.io:443` | `https://faucet.devnet.sui.io/v2/gas` |
|
|
22
22
|
| Testnet | `https://fullnode.testnet.sui.io:443` | `https://faucet.testnet.sui.io/v2/gas` |
|
|
@@ -36,18 +36,18 @@ The following table lists the locations for Sui networks.
|
|
|
36
36
|
The SDK contains a set of modular packages that you can use independently or together. Import just
|
|
37
37
|
what you need to keep your code light and compact.
|
|
38
38
|
|
|
39
|
-
- [`@mysten/sui/client`](/sui/clients)
|
|
40
|
-
- [`@mysten/sui/bcs`](/sui/bcs)
|
|
41
|
-
- [`@mysten/sui/transactions`](/sui/transaction-building/basics)
|
|
39
|
+
- [`@mysten/sui/client`](/sui/clients): A client for interacting with Sui RPC nodes.
|
|
40
|
+
- [`@mysten/sui/bcs`](/sui/bcs): A BCS builder with pre-defined types for Sui.
|
|
41
|
+
- [`@mysten/sui/transactions`](/sui/transaction-building/basics): Utilities for building and
|
|
42
42
|
interacting with transactions.
|
|
43
|
-
- [`@mysten/sui/keypairs/*`](/sui/cryptography/keypairs)
|
|
43
|
+
- [`@mysten/sui/keypairs/*`](/sui/cryptography/keypairs): Modular exports for specific KeyPair
|
|
44
44
|
implementations.
|
|
45
|
-
- [`@mysten/sui/verify`](/sui/cryptography/keypairs#verifying-signatures-without-a-key-pair)
|
|
45
|
+
- [`@mysten/sui/verify`](/sui/cryptography/keypairs#verifying-signatures-without-a-key-pair):
|
|
46
46
|
Methods for verifying transactions and messages.
|
|
47
|
-
- [`@mysten/sui/cryptography`](/sui/cryptography/keypairs)
|
|
47
|
+
- [`@mysten/sui/cryptography`](/sui/cryptography/keypairs): Shared types and classes for
|
|
48
48
|
cryptography.
|
|
49
|
-
- [`@mysten/sui/multisig`](/sui/cryptography/multisig)
|
|
49
|
+
- [`@mysten/sui/multisig`](/sui/cryptography/multisig): Utilities for working with multisig
|
|
50
50
|
signatures.
|
|
51
|
-
- [`@mysten/sui/utils`](/sui/utils)
|
|
52
|
-
- [`@mysten/sui/faucet`](/sui/faucet)
|
|
53
|
-
- [`@mysten/sui/zklogin`](/sui/zklogin)
|
|
51
|
+
- [`@mysten/sui/utils`](/sui/utils): Utilities for formatting and parsing various Sui types.
|
|
52
|
+
- [`@mysten/sui/faucet`](/sui/faucet): Methods for requesting SUI from a faucet.
|
|
53
|
+
- [`@mysten/sui/zklogin`](/sui/zklogin): Utilities for working with zkLogin.
|
package/dist/sui/install.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Install Sui TypeScript SDK
|
|
2
2
|
|
|
3
|
-
> Install the @mysten/sui package and configure your project
|
|
3
|
+
> Install the @mysten/sui package and configure your project.
|
|
4
4
|
|
|
5
5
|
The Sui TypeScript SDK is available in the
|
|
6
6
|
[Sui TS SDK monorepo](https://github.com/MystenLabs/ts-sdks) and NPM.
|
|
@@ -28,9 +28,9 @@ such as `"NodeNext"`, `"Node16"`, or `"Bundler"`. See the
|
|
|
28
28
|
|
|
29
29
|
## Experimental tag for use with a local Sui network
|
|
30
30
|
|
|
31
|
-
Projects developing against one of the
|
|
31
|
+
Projects developing against one of the onchain Sui networks (Devnet, Testnet, Mainnet) should use
|
|
32
32
|
the base SDK published in the NPM registry (previous section) because the code aligns with the
|
|
33
|
-
relevant JSON-RPC. If
|
|
33
|
+
relevant JSON-RPC. If you are developing against a
|
|
34
34
|
[local network](https://docs.sui.io/guides/developer/getting-started/local-network) built from the
|
|
35
35
|
`main` branch of the Sui monorepo, however, you should use the `experimental`-tagged SDK package as
|
|
36
36
|
it contains the latest features (or a local build detailed in the section that follows).
|
package/dist/sui/llm-docs.md
CHANGED
|
@@ -1,29 +1,29 @@
|
|
|
1
1
|
# LLM Documentation
|
|
2
2
|
|
|
3
|
-
> Give AI agents access to Sui SDK documentation in your project
|
|
3
|
+
> Give AI agents access to Sui SDK documentation in your project.
|
|
4
4
|
|
|
5
5
|
Every `@mysten/*` package ships a `docs/` directory containing flat markdown files optimized for AI
|
|
6
6
|
agent consumption. When you install an SDK package, you automatically get accurate, up-to-date
|
|
7
|
-
documentation that coding agents (Claude Code, Cursor, Copilot,
|
|
8
|
-
separate install or training data required.
|
|
7
|
+
documentation that coding agents (Claude Code, Cursor, Copilot, and others) can read directly. No
|
|
8
|
+
separate install or training data is required.
|
|
9
9
|
|
|
10
|
-
## How
|
|
10
|
+
## How it works
|
|
11
11
|
|
|
12
12
|
Each package includes:
|
|
13
13
|
|
|
14
|
-
- `docs/llms-index.md
|
|
15
|
-
- `docs/*.md
|
|
14
|
+
- `docs/llms-index.md`: Routing index listing all doc pages with descriptions
|
|
15
|
+
- `docs/*.md`: Individual reference pages
|
|
16
16
|
|
|
17
17
|
For example, installing `@mysten/sui` gives you docs at
|
|
18
18
|
`node_modules/@mysten/sui/docs/llms-index.md`.
|
|
19
19
|
|
|
20
|
-
## Configure
|
|
20
|
+
## Configure your agent
|
|
21
21
|
|
|
22
22
|
Add the following snippet to your agent's configuration file (`AGENTS.md`, `CLAUDE.md`,
|
|
23
|
-
`.cursorrules`,
|
|
23
|
+
`.cursorrules`, and others):
|
|
24
24
|
|
|
25
25
|
```markdown
|
|
26
|
-
## Sui SDK
|
|
26
|
+
## Sui SDK reference
|
|
27
27
|
|
|
28
28
|
Every @mysten/\* package ships LLM documentation in its `docs/` directory. When working with these
|
|
29
29
|
packages, find the relevant docs by looking for `docs/llms-index.md` files inside
|
package/dist/sui/llms-index.md
CHANGED
|
@@ -1,44 +1,44 @@
|
|
|
1
1
|
# Sui SDK
|
|
2
2
|
> TypeScript interfaces for Sui
|
|
3
3
|
|
|
4
|
-
- [Sui TypeScript SDK Quick Start](..md): TypeScript SDK for
|
|
5
|
-
- [Install Sui TypeScript SDK](./install.md): Install the @mysten/sui package and configure your project
|
|
6
|
-
- [LLM Documentation](./llm-docs.md): Give AI agents access to Sui SDK documentation in your project
|
|
7
|
-
- [Hello Sui](./hello-sui.md): Build your first Sui application with the TypeScript SDK
|
|
8
|
-
- [Faucet](./faucet.md): Request test SUI tokens from the faucet
|
|
9
|
-
- [Sui Clients](./clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients
|
|
10
|
-
- [Core API](./clients/core.md): Transport-agnostic Core API shared by all Sui clients
|
|
11
|
-
- [SuiGrpcClient](./clients/grpc.md): Connect to Sui
|
|
12
|
-
- [SuiGraphQLClient](./clients/graphql.md): Connect to Sui
|
|
13
|
-
- [SuiJsonRpcClient](./clients/json-rpc.md): Connect to Sui
|
|
14
|
-
- [Sui Programmable Transaction Basics](./transaction-building/basics.md): Construct programmable transaction blocks with the Transaction API
|
|
15
|
-
- [Paying for Sui Transactions with Gas Coins](./transaction-building/gas.md): Configure gas budget, price, and coin selection for transactions
|
|
16
|
-
- [Transaction Intents](./transaction-building/intents.md): Use high-level intents to simplify transaction building
|
|
17
|
-
- [Building Offline](./transaction-building/offline.md): Build transactions without a network connection
|
|
18
|
-
- [Sponsored Transactions](./transaction-building/sponsored-transactions.md): Pay gas fees on behalf of other users with sponsored transactions
|
|
19
|
-
- [Key pairs](./cryptography/keypairs.md): Create and manage Ed25519, Secp256k1, and Secp256r1 keypairs
|
|
20
|
-
- [Multi-Signature Transactions](./cryptography/multisig.md): Create multi-signature transactions with multiple signers
|
|
21
|
-
- [Passkey](./cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing
|
|
22
|
-
- [Web Crypto Signer](./cryptography/webcrypto-signer.md): Sign transactions using the Web Crypto API
|
|
23
|
-
- [The `@mysten/sui/utils` package](./utils.md): Utility functions for addresses, coins, and common operations
|
|
24
|
-
- [Derived Objects](./utils/derived_objects.md): Compute derived object IDs from parent objects
|
|
25
|
-
- [BCS](./bcs.md): Binary Canonical Serialization for encoding Sui Move types
|
|
26
|
-
- [ZkLogin](./zklogin.md): Zero-knowledge authentication with OAuth providers on Sui
|
|
27
|
-
- [Transaction Executors](./executors.md): Manage transaction execution with queuing and parallel strategies
|
|
28
|
-
- [Transaction Plugins](./plugins.md): Extend transaction building with reusable plugins
|
|
29
|
-
- [Building SDKs](./sdk-building.md): Build custom SDKs on top of the Sui TypeScript SDK
|
|
30
|
-
- [Migrate to 2.0](./migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0
|
|
31
|
-
- [Agent Migration Prompt](./migrations/sui-2.0/agent-prompt.md): AI agent prompt for automated SDK 2.0 migration
|
|
32
|
-
- [@mysten/sui](./migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0
|
|
33
|
-
- [Migrating from JSON-RPC](./migrations/sui-2.0/json-rpc-migration.md): Migrate from JSON-RPC to the new Core API
|
|
34
|
-
- [@mysten/dapp-kit](./migrations/sui-2.0/dapp-kit.md): Migrate @mysten/dapp-kit to 2.0
|
|
35
|
-
- [@mysten/kiosk](./migrations/sui-2.0/kiosk.md): Migrate @mysten/kiosk to 2.0
|
|
36
|
-
- [@mysten/zksend](./migrations/sui-2.0/zksend.md): Migrate @mysten/zksend to 2.0
|
|
37
|
-
- [@mysten/suins](./migrations/sui-2.0/suins.md): Migrate @mysten/suins to 2.0
|
|
38
|
-
- [@mysten/deepbook-v3](./migrations/sui-2.0/deepbook-v3.md): Migrate @mysten/deepbook-v3 to 2.0
|
|
39
|
-
- [@mysten/walrus](./migrations/sui-2.0/walrus.md): Migrate @mysten/walrus to 2.0
|
|
40
|
-
- [@mysten/seal](./migrations/sui-2.0/seal.md): Migrate @mysten/seal to 2.0
|
|
41
|
-
- [Wallet Builders](./migrations/sui-2.0/wallet-builders.md): Migration guide for wallet extension developers
|
|
42
|
-
- [SDK Maintainers](./migrations/sui-2.0/sdk-maintainers.md): Migration guide for SDK maintainers and library authors
|
|
43
|
-
- [Migrate to 1.0](./migrations/sui-1.0.md): Migrate to Sui TypeScript SDK 1.0
|
|
44
|
-
- [Migrate to 0.38.0](./migrations/0.38.md): Migrate from SDK version 0.37 to 0.38
|
|
4
|
+
- [Sui TypeScript SDK Quick Start](..md): The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain.
|
|
5
|
+
- [Install Sui TypeScript SDK](./install.md): Install the @mysten/sui package and configure your project.
|
|
6
|
+
- [LLM Documentation](./llm-docs.md): Give AI agents access to Sui SDK documentation in your project.
|
|
7
|
+
- [Hello Sui](./hello-sui.md): Build your first Sui application with the TypeScript SDK.
|
|
8
|
+
- [Faucet](./faucet.md): Request test SUI tokens from the faucet on Devnet, Testnet, or local networks.
|
|
9
|
+
- [Sui Clients](./clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients for the Sui network.
|
|
10
|
+
- [Core API](./clients/core.md): Transport-agnostic Core API shared by all Sui clients.
|
|
11
|
+
- [SuiGrpcClient](./clients/grpc.md): Connect to Sui through gRPC with SuiGrpcClient.
|
|
12
|
+
- [SuiGraphQLClient](./clients/graphql.md): Connect to Sui through GraphQL with SuiGraphQLClient.
|
|
13
|
+
- [SuiJsonRpcClient](./clients/json-rpc.md): Connect to Sui through JSON-RPC with SuiJsonRpcClient.
|
|
14
|
+
- [Sui Programmable Transaction Basics](./transaction-building/basics.md): Construct programmable transaction blocks with the Transaction API.
|
|
15
|
+
- [Paying for Sui Transactions with Gas Coins](./transaction-building/gas.md): Configure gas budget, price, and coin selection for Sui transactions.
|
|
16
|
+
- [Transaction Intents](./transaction-building/intents.md): Use high-level intents to simplify transaction building.
|
|
17
|
+
- [Building Offline](./transaction-building/offline.md): Build transactions without a network connection.
|
|
18
|
+
- [Sponsored Transactions](./transaction-building/sponsored-transactions.md): Pay gas fees on behalf of other users with sponsored transactions.
|
|
19
|
+
- [Key pairs](./cryptography/keypairs.md): Create and manage Ed25519, Secp256k1, and Secp256r1 keypairs for Sui transaction signing.
|
|
20
|
+
- [Multi-Signature Transactions](./cryptography/multisig.md): Create multi-signature transactions with multiple signers on Sui.
|
|
21
|
+
- [Passkey](./cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing.
|
|
22
|
+
- [Web Crypto Signer](./cryptography/webcrypto-signer.md): Sign transactions using the Web Crypto API for secure browser-based key management.
|
|
23
|
+
- [The `@mysten/sui/utils` package](./utils.md): Utility functions for addresses, coins, and common operations in the Sui TypeScript SDK.
|
|
24
|
+
- [Derived Objects](./utils/derived_objects.md): Compute derived object IDs from parent objects for deterministic offline derivation.
|
|
25
|
+
- [BCS](./bcs.md): Binary Canonical Serialization for encoding Sui Move types.
|
|
26
|
+
- [ZkLogin](./zklogin.md): Zero-knowledge authentication with OAuth providers on Sui.
|
|
27
|
+
- [Transaction Executors](./executors.md): Manage transaction execution with queuing and parallel strategies.
|
|
28
|
+
- [Transaction Plugins](./plugins.md): Extend transaction building with reusable plugins.
|
|
29
|
+
- [Building SDKs](./sdk-building.md): Build custom SDKs on top of the Sui TypeScript SDK.
|
|
30
|
+
- [Migrate to 2.0](./migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0 covering all @mysten packages.
|
|
31
|
+
- [Agent Migration Prompt](./migrations/sui-2.0/agent-prompt.md): AI agent prompt for automated SDK 2.0 migration of your codebase.
|
|
32
|
+
- [@mysten/sui](./migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0 with new client APIs and BCS changes.
|
|
33
|
+
- [Migrating from JSON-RPC](./migrations/sui-2.0/json-rpc-migration.md): Migrate from JSON-RPC to the new Core API using SuiGrpcClient or SuiGraphQLClient.
|
|
34
|
+
- [@mysten/dapp-kit](./migrations/sui-2.0/dapp-kit.md): Migrate @mysten/dapp-kit to the new dapp-kit-react package in 2.0.
|
|
35
|
+
- [@mysten/kiosk](./migrations/sui-2.0/kiosk.md): Migrate @mysten/kiosk to 2.0 with client extension pattern and KioskTransaction.
|
|
36
|
+
- [@mysten/zksend](./migrations/sui-2.0/zksend.md): Migrate @mysten/zksend to 2.0 with client extension pattern and simplified API.
|
|
37
|
+
- [@mysten/suins](./migrations/sui-2.0/suins.md): Migrate @mysten/suins to 2.0 with client extension pattern.
|
|
38
|
+
- [@mysten/deepbook-v3](./migrations/sui-2.0/deepbook-v3.md): Migrate @mysten/deepbook-v3 to 2.0 with client extension pattern.
|
|
39
|
+
- [@mysten/walrus](./migrations/sui-2.0/walrus.md): Migrate @mysten/walrus to 2.0 with required client parameter and updated API.
|
|
40
|
+
- [@mysten/seal](./migrations/sui-2.0/seal.md): Migrate @mysten/seal to 2.0 with the new registration function pattern.
|
|
41
|
+
- [Wallet Builders](./migrations/sui-2.0/wallet-builders.md): Migration guide for wallet extension developers upgrading to 2.0.
|
|
42
|
+
- [SDK Maintainers](./migrations/sui-2.0/sdk-maintainers.md): Migration guide for SDK maintainers and library authors upgrading to 2.0.
|
|
43
|
+
- [Migrate to 1.0](./migrations/sui-1.0.md): Migrate to Sui TypeScript SDK 1.0 with new features and API changes.
|
|
44
|
+
- [Migrate to 0.38.0](./migrations/0.38.md): Migrate from SDK version 0.37 to 0.38 with updated module structure and API changes.
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Migrate to 0.38.0
|
|
2
2
|
|
|
3
|
-
> Migrate from SDK version 0.37 to 0.38
|
|
3
|
+
> Migrate from SDK version 0.37 to 0.38 with updated module structure and API changes.
|
|
4
4
|
|
|
5
|
-
> **Warning:** The 1.0 release of the SDK contains many additional changes. This document
|
|
5
|
+
> **Warning:** The 1.0 release of the SDK contains many additional changes. This document might help as an
|
|
6
6
|
> intermediate step when upgrading from older versions of the SDK, but all apps should be upgraded to
|
|
7
7
|
> the latest version of the SDK instead of 0.38.0.
|
|
8
8
|
|
|
@@ -19,13 +19,13 @@ the complete SDK module. Now, you upload the individual packages of the SDK modu
|
|
|
19
19
|
|
|
20
20
|
The Sui TypeScript SDK deprecates the following classes with version 0.38.0:
|
|
21
21
|
|
|
22
|
-
- `JsonRpcProvider
|
|
22
|
+
- `JsonRpcProvider`: The `JsonRpcProvider` class is deprecated in favor of the `suiClient` class
|
|
23
23
|
when creating a client for a Sui network. See
|
|
24
24
|
[Network Interactions with SuiJsonRpcClient](/sui/clients) for more information.
|
|
25
25
|
- `SignerWithProver` and `RawSigner` - Key pairs now directly support signing transactions and
|
|
26
26
|
messages without the need of a `Signer` class. See the [Key pairs](/sui/cryptography/keypairs)
|
|
27
27
|
topic for more information.
|
|
28
|
-
- `signAndExecuteTransaction
|
|
28
|
+
- `signAndExecuteTransaction`: This method was not deprecated, but is now part of
|
|
29
29
|
`SuiJsonRpcClient`.
|
|
30
30
|
- `Connection` classes - The `Connection` classes (`Connection`, `devnetConnection`, and so on) have
|
|
31
31
|
been deprecated in favor ofSuiJsonRpcClientuiClient` for establishing the connection. See
|
|
@@ -33,8 +33,8 @@ The Sui TypeScript SDK deprecates the following classes with version 0.38.0:
|
|
|
33
33
|
- The `superstruct` type definitions for `JsonRPCProvider` types are replaced with generated types
|
|
34
34
|
exported from `@mysten/sui/client`. The new type definitions are pure TypeScript types that you
|
|
35
35
|
can't use for runtime validation.
|
|
36
|
-
- A more stable JSON-RPC API has reduced the need for many of the SDK
|
|
37
|
-
|
|
36
|
+
- A more stable JSON-RPC API has reduced the need for many of the SDK getter methods, which are now
|
|
37
|
+
deprecated.
|
|
38
38
|
|
|
39
39
|
### Signing transactions
|
|
40
40
|
|