Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/maticnetwork/matic.js

Javascript developer library to interact with Matic Network
https://github.com/maticnetwork/matic.js

dapps ethereum matic maticnetwork polygon sidechain smart-contracts web3

Last synced: 29 days ago
JSON representation

Javascript developer library to interact with Matic Network

Host: GitHub
URL: https://github.com/maticnetwork/matic.js
Owner: maticnetwork
License: mit
Created: 2018-08-23T12:50:03.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2024-03-26T14:41:52.000Z (4 months ago)
Last Synced: 2024-06-06T15:05:36.477Z (about 1 month ago)
Topics: dapps, ethereum, matic, maticnetwork, polygon, sidechain, smart-contracts, web3
Language: TypeScript
Homepage: https://wiki.polygon.technology/docs/tools/matic-js/get-started/
Size: 28.3 MB
Stars: 536
Watchers: 38
Forks: 257
Open Issues: 15
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md

Lists

awesome-stars - maticnetwork/matic.js - Javascript developer library to interact with Matic Network (TypeScript)
best-of-crypto - GitHub - 15% open · ⏱️ 19.03.2024): (Smart Contract Platforms)

README

# Matic SDK

[![GitHub version](https://badge.fury.io/gh/maticnetwork%2Fmatic.js.svg)](https://badge.fury.io/gh/maticnetwork%2Fmatic.js)
![Build Status](https://github.com/maticnetwork/matic.js/workflows/CI/badge.svg?branch=master)
[![npm version](https://badge.fury.io/js/%40maticnetwork%2Fmaticjs.svg)](https://badge.fury.io/js/%40maticnetwork%2Fmaticjs)
![GitHub](https://img.shields.io/github/license/maticnetwork/matic.js)
[![TEST](https://github.com/maticnetwork/matic.js/actions/workflows/test.yml/badge.svg)](https://github.com/maticnetwork/matic.js/actions/workflows/test.yml)

This repository contains the `maticjs` client library. `maticjs` makes it easy for developers, who may not be deeply familiar with smart contract development, to interact with the various components of Matic Network.

This library will help developers to move assets from Ethereum chain to Matic chain, and withdraw from Matic to Ethereum using fraud proofs.

## Docs

[https://wiki.polygon.technology/docs/tools/matic-js/get-started](https://wiki.polygon.technology/docs/tools/matic-js/get-started/)

## Support

Our [Discord](https://discord.gg/0xPolygonDevs) is the best way to reach us ✨.

## Contributors

You are very welcome to contribute, please see contributing guidelines - [[Contribute](CONTRIBUTING.md)].

Thank you to all the people who already contributed to matic.js!

Made with [contributors-img](https://contrib.rocks).

## Development

**Setup**

```bash
npm ci
```

**How to debug**

Write your code inside file `test/debug.js` and run below code

```bash
npm run debug
```

Above command will build the source code & install the built version into test folder, which will be used by `debug.js`.

**Lint**

```bash
# To check lint errors
npm run lint

# To fix most common lint errors
# Note that it might not fix all errors, some need manual intervention
npm run lint:fix
```

**Build code**

```bash
npm run build
```

**Run test**

```bash
npm run test
```

**Generate distribution files**

```bash
npm run deploy
```

**NPM publish**

Before running publish script, make sure you have updated version properly.

Note that `prepublishOnly` script will be automatically called while publishing. It will check lint, clean dist/lib folders and build fresh distribution files before it executes `npm publish`.

```bash
npm publish
```

### License

MIT