Skip to content

Commit

Permalink
[docs] Update README to match the new SDK
Browse files Browse the repository at this point in the history
  • Loading branch information
gregnazario committed Oct 10, 2023
1 parent 1819e03 commit 16a2d32
Showing 1 changed file with 15 additions and 49 deletions.
64 changes: 15 additions & 49 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,27 @@
# SDK for Aptos Node API
# Typescript SDK for Aptos

[![Discord][discord-image]][discord-url]
[![NPM Package Version][npm-image-version]][npm-url]
[![NPM Package Downloads][npm-image-downloads]][npm-url]

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.
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.

This repository supports version >= 2.0.0 of the [Aptos SDK npm package](https://www.npmjs.com/package/aptos).

## Installation

##### For use in Node.js or a web application

```ts
pnpm install aptos
Install with your favorite package manager such as npm, yarn, or pnpm:
```bash
npm install aptos
```

You can also use your preferred npm client, such as yarn or npm.

##### For use in a browser

```ts
You can add the SDK to your web application using a script tag:
```html
<script src="https://unpkg.com/aptos@latest/dist/index.global.js" />
```
Expand All @@ -27,58 +30,21 @@ Then, the SDK can be accessed through `window.aptosSDK`.
## Documentation and examples
- [The Aptos documentation site](https://aptos.dev/sdks/ts-sdk/index) provides step-by-step instructions, code snippets, and best practices to use this library.
- You can view the generated [Type Doc](https://aptos-labs.github.io/ts-sdk-doc/) for the latest release of the SDK.
- For in-depth examples, check out the [examples](./examples) folder with ready-made `package.json` files to get you going quickly!
### Development environment setup

Setup an `.env` file to configure the URLs.
From the [root](https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/typescript/sdk) of this package, run:

```ts
rm .env
echo 'APTOS_NODE_URL="http://localhost:8080/v1"' >> .env
echo 'APTOS_FAUCET_URL="http://localhost:8081"' >> .env
```

### Testing
To run the full SDK tests, From the [root](https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/typescript/sdk) of this package, run:
To run the SDK tests, simply run from the root of this repository:
```ts
```bash
pnpm test
```
> If you see strange behavior regarding HTTP clients, try running the tests with `--detectOpenHandles`.
To test a single file in the SDK, From the [root](https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/typescript/sdk) of this package, run:

```ts
npx jest -- <path/to/file.test.ts>
```

To use the local build in a local project:

```ts
// run from the root of this package
pnpm build
// run on your local project
pnpm add PATH_TO_LOCAL_SDK_PACKAGE
```

### Working with local node

To develop in a local environment, you need to use the SDK from the [main](https://github.com/aptos-labs/aptos-core/tree/main/ecosystem/typescript/sdk) branch.

Run a local node (run from the root of the [repo](https://github.com/aptos-labs/aptos-core/)):

```ts
cargo run -p aptos -- node run-local-testnet --force-restart --assume-yes
```

## Contributing
If you found a bug or would like to request a feature, please file an [issue](https://github.com/aptos-labs/aptos-core/issues/new/choose). If, based on the discussion on an issue you would like to offer a code change, please make a [pull request](./CONTRIBUTING.md). If neither of these describes what you would like to contribute, checkout out the [contributing guide](./CONTRIBUTING.md).
If you found a bug or would like to request a feature, please file an [issue](https://github.com/aptos-labs/aptos-ts-sdk/issues/new/choose).
If, based on the discussion on an issue you would like to offer a code change, please make a [pull request](./CONTRIBUTING.md).
If neither of these describes what you would like to contribute, checkout out the [contributing guide](./CONTRIBUTING.md).
[npm-image-version]: https://img.shields.io/npm/v/aptos.svg
[npm-image-downloads]: https://img.shields.io/npm/dm/aptos.svg
Expand Down

0 comments on commit 16a2d32

Please sign in to comment.