@mysten/docs 0.1.18 → 0.1.20

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.
Files changed (107) hide show
  1. package/dist/bcs/index.md +1 -1
  2. package/dist/bcs/llms-index.md +1 -1
  3. package/dist/codegen/index.md +53 -53
  4. package/dist/codegen/llms-index.md +1 -1
  5. package/dist/dapp-kit/actions/connect-wallet.md +4 -4
  6. package/dist/dapp-kit/actions/disconnect-wallet.md +8 -7
  7. package/dist/dapp-kit/actions/sign-and-execute-transaction.md +14 -14
  8. package/dist/dapp-kit/actions/sign-personal-message.md +8 -8
  9. package/dist/dapp-kit/actions/sign-transaction.md +7 -7
  10. package/dist/dapp-kit/actions/switch-account.md +6 -6
  11. package/dist/dapp-kit/actions/switch-network.md +5 -5
  12. package/dist/dapp-kit/dapp-kit-instance.md +19 -18
  13. package/dist/dapp-kit/getting-started/create-dapp.md +12 -12
  14. package/dist/dapp-kit/getting-started/next-js.md +12 -11
  15. package/dist/dapp-kit/getting-started/react.md +25 -25
  16. package/dist/dapp-kit/getting-started/vue.md +12 -12
  17. package/dist/dapp-kit/index.md +4 -4
  18. package/dist/dapp-kit/llms-index.md +23 -23
  19. package/dist/dapp-kit/react/components/connect-button.md +3 -3
  20. package/dist/dapp-kit/react/components/connect-modal.md +3 -3
  21. package/dist/dapp-kit/react/components/index.md +2 -2
  22. package/dist/dapp-kit/react/dapp-kit-provider.md +6 -6
  23. package/dist/dapp-kit/react/hooks/index.md +4 -3
  24. package/dist/dapp-kit/react/hooks/use-current-account.md +3 -3
  25. package/dist/dapp-kit/react/hooks/use-current-client.md +3 -3
  26. package/dist/dapp-kit/react/hooks/use-current-network.md +3 -3
  27. package/dist/dapp-kit/react/hooks/use-current-wallet.md +3 -3
  28. package/dist/dapp-kit/react/hooks/use-dapp-kit.md +5 -5
  29. package/dist/dapp-kit/react/hooks/use-wallet-connection.md +3 -3
  30. package/dist/dapp-kit/react/hooks/use-wallets.md +3 -3
  31. package/dist/dapp-kit/state.md +16 -16
  32. package/dist/dapp-kit/theming.md +27 -27
  33. package/dist/dapp-kit/web-components/connect-button.md +9 -9
  34. package/dist/dapp-kit/web-components/connect-modal.md +16 -16
  35. package/dist/kiosk/advanced-examples.md +1 -1
  36. package/dist/kiosk/from-v1.md +1 -1
  37. package/dist/kiosk/index.md +5 -5
  38. package/dist/kiosk/kiosk-client/introduction.md +6 -6
  39. package/dist/kiosk/kiosk-client/kiosk-transaction/examples.md +3 -3
  40. package/dist/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction.md +1 -1
  41. package/dist/kiosk/kiosk-client/kiosk-transaction/managing.md +11 -11
  42. package/dist/kiosk/kiosk-client/kiosk-transaction/purchasing.md +1 -1
  43. package/dist/kiosk/kiosk-client/querying.md +1 -1
  44. package/dist/kiosk/kiosk-client/transfer-policy-transaction/introduction.md +1 -1
  45. package/dist/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager.md +1 -3
  46. package/dist/kiosk/llms-index.md +5 -5
  47. package/dist/llms-index.md +83 -83
  48. package/dist/payment-kit/getting-started.md +13 -13
  49. package/dist/payment-kit/index.md +13 -13
  50. package/dist/payment-kit/llms-index.md +5 -5
  51. package/dist/payment-kit/payment-kit-sdk.md +18 -18
  52. package/dist/payment-kit/payment-processing.md +34 -34
  53. package/dist/payment-kit/registry-management.md +35 -35
  54. package/dist/seal/index.md +5 -5
  55. package/dist/seal/llms-index.md +1 -1
  56. package/dist/slush-wallet/dapp.md +10 -10
  57. package/dist/slush-wallet/deep-linking.md +54 -54
  58. package/dist/slush-wallet/index.md +2 -2
  59. package/dist/slush-wallet/llms-index.md +3 -3
  60. package/dist/sui/bcs.md +11 -11
  61. package/dist/sui/clients/core.md +57 -56
  62. package/dist/sui/clients/graphql.md +3 -3
  63. package/dist/sui/clients/grpc.md +10 -10
  64. package/dist/sui/clients/index.md +14 -14
  65. package/dist/sui/clients/json-rpc.md +16 -16
  66. package/dist/sui/cryptography/keypairs.md +6 -6
  67. package/dist/sui/cryptography/multisig.md +4 -4
  68. package/dist/sui/cryptography/passkey.md +15 -14
  69. package/dist/sui/cryptography/webcrypto-signer.md +4 -4
  70. package/dist/sui/executors.md +18 -16
  71. package/dist/sui/faucet.md +3 -3
  72. package/dist/sui/hello-sui.md +5 -5
  73. package/dist/sui/index.md +12 -12
  74. package/dist/sui/install.md +3 -3
  75. package/dist/sui/llm-docs.md +9 -9
  76. package/dist/sui/llms-index.md +41 -41
  77. package/dist/sui/migrations/0.38.md +6 -6
  78. package/dist/sui/migrations/sui-1.0.md +32 -32
  79. package/dist/sui/migrations/sui-2.0/agent-prompt.md +3 -3
  80. package/dist/sui/migrations/sui-2.0/dapp-kit.md +43 -43
  81. package/dist/sui/migrations/sui-2.0/deepbook-v3.md +1 -1
  82. package/dist/sui/migrations/sui-2.0/index.md +37 -37
  83. package/dist/sui/migrations/sui-2.0/json-rpc-migration.md +53 -47
  84. package/dist/sui/migrations/sui-2.0/kiosk.md +8 -8
  85. package/dist/sui/migrations/sui-2.0/sdk-maintainers.md +7 -7
  86. package/dist/sui/migrations/sui-2.0/seal.md +1 -1
  87. package/dist/sui/migrations/sui-2.0/sui.md +16 -16
  88. package/dist/sui/migrations/sui-2.0/suins.md +4 -3
  89. package/dist/sui/migrations/sui-2.0/wallet-builders.md +5 -5
  90. package/dist/sui/migrations/sui-2.0/walrus.md +3 -3
  91. package/dist/sui/migrations/sui-2.0/zksend.md +5 -5
  92. package/dist/sui/plugins.md +14 -14
  93. package/dist/sui/sdk-building.md +32 -32
  94. package/dist/sui/transaction-building/basics.md +13 -13
  95. package/dist/sui/transaction-building/gas.md +2 -3
  96. package/dist/sui/transaction-building/intents.md +4 -4
  97. package/dist/sui/transaction-building/offline.md +8 -8
  98. package/dist/sui/transaction-building/sponsored-transactions.md +1 -1
  99. package/dist/sui/utils/derived_objects.md +10 -10
  100. package/dist/sui/utils/index.md +1 -1
  101. package/dist/sui/zklogin.md +1 -1
  102. package/dist/walrus/index.md +1 -1
  103. package/dist/walrus/llms-index.md +1 -1
  104. package/dist/zksend/index.md +2 -2
  105. package/dist/zksend/link-builder.md +5 -4
  106. package/dist/zksend/llms-index.md +2 -2
  107. 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` and additional options. Note that
23
- `getPasskeyInstance` call will initialize a new passkey wallet for the origin.
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 since they do not remember which passkey is the way that the wallet was created for.
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 prompt to recover the public key
58
- (e.g. "Log in to existing passkey wallet") to be able to use the passkey wallet again. If the user
59
- is prompted to create a new key in passkey device, a fresh new wallet with new address will be
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 may derive the addresses for both, and check
84
- onchain for the unique address that contains assets. Or the frontend may retrieve additional
85
- signatures from past transaction history for the given address. This may a preferred user experience
86
- since the user is only prompted to sign one message, but the frontend needs to do extra work.
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 Platforms
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 dapps, we recommend using the Web
6
- Crypto Signer. This signer leverages the
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
@@ -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 Typescript SDK ships 2 Transaction executor classes that simplify the processes of efficiently
6
- executing multiple transactions signed by the same address. These executors help manage object
7
- versions and gas coins which significantly reduces the number of requests made to RPC nodes, and for
8
- many cases avoids the need to wait for the RPC nodes to index previously executed transactions.
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, and dapps where the
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 may change rapidly as it is being developed.
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 may consume/combine gas coins in the gasPool, causing
73
- > transactions to fail. This may also result in the coins becoming locked for the remainder of the
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` Time to wait before/after the expected epoch boundary before re-fetching the
103
- gas pool (in milliseconds). Building transactions will be paused for up to 2x this duration around
104
- each epoch boundary to ensure the gas price is up-to-date for the next epoch. (default `1000`)
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 Executing Transactions with Executors
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`/`version`/`digest` for an object input (eg use `tx.object(id)` rather than
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 may cause
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 may resolve their own data (such as object references) that are
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
@@ -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 testnet, the best way to get SUI is via
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`.
@@ -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 have
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 testnet, the best way to get SUI is via
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 building on the Sui blockchain
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) - 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
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) - Modular exports for specific KeyPair
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) - Shared types and classes for
47
+ - [`@mysten/sui/cryptography`](/sui/cryptography/keypairs): Shared types and classes for
48
48
  cryptography.
49
- - [`@mysten/sui/multisig`](/sui/cryptography/multisig) - Utilities for working with multisig
49
+ - [`@mysten/sui/multisig`](/sui/cryptography/multisig): Utilities for working with multisig
50
50
  signatures.
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.
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.
@@ -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 on-chain Sui networks (Devnet, Testnet, Mainnet) should use
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 your developing against a
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).
@@ -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, etc.) can read directly — no
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 It Works
10
+ ## How it works
11
11
 
12
12
  Each package includes:
13
13
 
14
- - `docs/llms-index.md` — routing index listing all doc pages with descriptions
15
- - `docs/*.md` — individual reference pages
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 Your Agent
20
+ ## Configure your agent
21
21
 
22
22
  Add the following snippet to your agent's configuration file (`AGENTS.md`, `CLAUDE.md`,
23
- `.cursorrules`, etc.):
23
+ `.cursorrules`, and others):
24
24
 
25
25
  ```markdown
26
- ## Sui SDK Reference
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
@@ -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 building on 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
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 via gRPC with SuiGrpcClient
12
- - [SuiGraphQLClient](./clients/graphql.md): Connect to Sui via GraphQL with SuiGraphQLClient
13
- - [SuiJsonRpcClient](./clients/json-rpc.md): Connect to Sui via 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 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 may help help as an
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` - The `JsonRpcProvider` class is deprecated in favor of the `suiClient` class
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` - This method was not deprecated, but is now part of
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 "getter" methods, which are
37
- now deprecated.
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