Skip to content

Javascript Utility Library for PoolTogether V5 off-chain calculations, computations and core logic.

License

Notifications You must be signed in to change notification settings

pooltogether/v5-utils-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PoolTogether Brand


🧰 Javascript Utility Library - PoolTogether V5

Documentation

Calculations, Computations and Core Logic

The @pooltogether/v5-utils-js node module package provides computations for the PoolTogether v5 protocol.

High-order operations like processing subgraphs and chain state (draws, winners, etc..) is included in the computations namespaced functions.

🖥️ Computations:

Consume subgraph and protocol chain state to return computed outcomes:

Create Issue to request new features.
Open Pull Request adhering to Contribution guidelines.

💾 Installation

This project is available as an NPM package:

npm install @pooltogether/v5-utils-js
yarn add @pooltogether/v5-utils-js

The repo can be cloned from Github for contributions.

git clone https://github.com/pooltogether/v5-utils-js

🏆 Quickstart (Contracts Blob)

Getting the list of contracts for a specific network is easy using the downloadContractsBlob(chainId) function.

Currently supports:

  • Sepolia (testnet)
  • Mumbai (testnet)
  • Goerli (testnet) (outdated!)
import { downloadContractsBlob } from "@pooltogether/v5-utils-js";

async function main() {
  const contracts = await downloadContractsBlob(chainId);
}
main();

🏆 Quickstart (Draw Results)

computeDrawWinners(provider, contracts, chainId, filterAutoClaimDisabled?: boolean) computes and returns a JSON blob of winner's Claim objects for each tier of a prize pool, grouped by vault for the previous draw.

import { computeDrawWinners } from "@pooltogether/v5-utils-js";

// Compute Winners for the last Draw
const winners = computeDrawWinners(provider, contracts, chainId, filterAutoClaimDisabled?: boolean);

📖 Documentation

Namespaces

About

Javascript Utility Library for PoolTogether V5 off-chain calculations, computations and core logic.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published