@aptos-labs/ts-sdk 0.0.8 → 1.0.0

package/README.md

@@ -5,19 +5,16 @@
 [![NPM Package Downloads][npm-image-downloads]][npm-url]
 
 ### Latest Version
+
 [![NPM Package Version][npm-image-version]][npm-url]
 ![Node Version](https://img.shields.io/node/v/%40aptos-labs%2Fts-sdk)
 ![NPM bundle size](https://img.shields.io/bundlephobia/min/%40aptos-labs/ts-sdk)
 
 ### Experimental Development Version
+
 [![NPM Experimental Version](https://img.shields.io/npm/v/%40aptos-labs/ts-sdk/experimental)][experimental-url]
 ![Experimental Node Version](https://img.shields.io/node/v/%40aptos-labs%2Fts-sdk/experimental)
-![Experimental bundle size](https://img.shields.io/bundlephobia/min/%40aptos-labs/ts-sdk/experimental
-)
-
-
-
-> **This library is experimental**. Therefore, the API is unstable and may change without warning.
+![Experimental bundle size](https://img.shields.io/bundlephobia/min/%40aptos-labs/ts-sdk/experimental)
 
 The Aptos TypeScript SDK provides a convenient way to interact with the Aptos blockchain using TypeScript. It offers a
 set of utility functions, classes, and types to simplify the integration process and enhance developer productivity.
@@ -31,7 +28,7 @@ This repository supports version >= 0.0.0 of the [Aptos SDK npm package](https:/
 Install with your favorite package manager such as npm, yarn, or pnpm:
 
 ```bash
-pnpm install @aptos-labs/ts-sdk@experimental
+pnpm install @aptos-labs/ts-sdk
 ```
 
 ##### For use in a browser
@@ -39,7 +36,7 @@ pnpm install @aptos-labs/ts-sdk@experimental
 You can add the SDK to your web application using a script tag:
 
 ```html
-<script src="https://unpkg.com/@aptos-labs/ts-sdk@experimental/dist/browser/index.global.js" />
+<script src="https://unpkg.com/@aptos-labs/ts-sdk/dist/browser/index.global.js" />
 ```
 
 Then, the SDK can be accessed through `window.aptosSDK`.
@@ -57,7 +54,7 @@ If you want to pass in a custom config
 
 ```ts
 // an optional config information for the SDK client instance.
-const config = new AptosConfig({ network: Network.LOCAL });
+const config = new AptosConfig({ network: Network.LOCAL }); // default network is devnet
 const aptos = new Aptos(config);
 ```
 
@@ -69,7 +66,7 @@ const aptos = new Aptos(config);
 const modules = await aptos.getAccountModules({ accountAddress: "0x123" });
 ```
 
-### Keys management (default to Ed25519)
+### Account management (default to Ed25519)
 
 > Note: We introduce a Single Sender authentication (as introduced in [AIP-55](https://github.com/aptos-foundation/AIPs/pull/263)). Generating an account defaults to Legacy Ed25519 authentication with the option to use the Single Sender unified authentication
 
@@ -112,8 +109,9 @@ Using transaction submission api
 ```ts
 const alice: Account = Account.generate();
 const bobAddress = "0xb0b";
+// build transaction
 const transaction = await aptos.build.transaction({
-  sender: alice.accountAddress.toString(),
+  sender: alice,
   data: {
     function: "0x1::coin::transfer",
     type_arguments: ["0x1::aptos_coin::AptosCoin"],
@@ -132,11 +130,12 @@ const committedTransaction = await aptos.signAndSubmitTransaction({ signer: alic
 Using built in `transferCoinTransaction`
 
 ```ts
-const alice: Account;
+const alice: Account = Account.generate();
 const bobAddress = "0xb0b";
+// build transaction
 const transaction = await aptos.transferCoinTransaction({
-  sender: alice.accountAddress.toString(),
-  recipient: bob,
+  sender: alice,
+  recipient: bobAddress,
   amount: 100,
 });
 
@@ -145,6 +144,7 @@ const pendingTransaction = await aptos.signAndSubmitTransaction({ signer: alice,
 
 ## Documentation and examples
 
+- For full SDK documentation, check out the [TypeScript SDK documentation](https://aptos.dev/sdks/ts-sdk-v2/)
 - For reference documenation, check out the [API reference documentation](https://aptos-labs.github.io/aptos-ts-sdk/) for the associated version.
 - For in-depth examples, check out the [examples](./examples) folder with ready-made `package.json` files to get you going quickly!
 

package/dist/browser/index.d.ts

@@ -4994,6 +4994,26 @@ declare class DigitalAsset {
         minimumLedgerVersion?: AnyNumber;
         options?: PaginationArgs & OrderByArg<GetTokenActivityResponse[0]>;
     }): Promise<GetTokenActivityResponse>;
+    /**
+     * Transfer a digital asset (non fungible token) ownership.
+     *
+     * We can transfer a digital asset only when the digital asset is not frozen
+     * (i.e. owner transfer is not disabled such as for soul bound tokens)
+     *
+     * @param args.sender The sender account of the current digital asset owner
+     * @param args.digitalAssetAddress The digital asset address
+     * @param args.recipient The recipient account address
+     * @param args.digitalAssetType optional. The digital asset type, default to "0x4::token::Token"
+     *
+     * @returns A SingleSignerTransaction that can be simulated or submitted to chain
+     */
+    transferDigitalAsset(args: {
+        sender: Account$1;
+        digitalAssetAddress: AccountAddressInput;
+        recipient: AccountAddress;
+        digitalAssetType?: MoveStructId;
+        options?: InputGenerateTransactionOptions;
+    }): Promise<SingleSignerTransaction>;
 }
 
 /**