npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@generalprotocols/anyhedge

v2.0.2

Published

Library for creation, validation and management of AnyHedge contracts on the Bitcoin Cash blockchain.

Downloads

1,085

Readme

AnyHedge Library

Library for creation, validation and management of AnyHedge contracts.

Installation

Install the library via NPM:

# npm install @generalprotocols/anyhedge

Introduction

Full Documentation

Developing with AnyHedge is easy but depends on some base knowledge of developing with Bitcoin Cash. The usage instructions below show the key steps and have links to further documentation. We also include a custodial funding example as a reference that shows both the preparation and the AnyHedge steps. To run the custodial example, clone the AnyHedge repo and run npm install and npm run build as prerequisites.

Usage

Setting up

Include the AnyHedgeManager into your project.

// Load the AnyHedge library.
import { AnyHedgeManager } from '@generalprotocols/anyhedge';

// Create an instance of the contract manager with the authentication token included.
const authenticationToken = '<authentication token>';
const manager = new AnyHedgeManager({ authenticationToken });

Requesting an authentication token

In order to use the automated settlement services, you need to request an authentication token.

const authenticationToken = await manager.requestAuthenticationToken('My name');

Alternatively you can request an authentication token by sending a direct API request with curl.

curl -d 'name=My name' "https://api.anyhedge.com/api/v2/requestToken"

This token then needs to be passed into the constructor of an AnyHedgeManager.

Creating a contract

Create a new contract:

// Create new contract.
const contractData = await manager.createContract(...parameters);

// Retrieve its address
const contractAddress = contractData.address;

Registering a contract for automatic redemption

Register a contract for automatic settlement:

// Submit a contract for external redemption management.
const contractData = await manager.registerContractForSettlement(...parameters);

Retrieving a registered contract's information

Get the contract information for any contract that has been registered with the settlement service:

const contractData = await manager.getContractStatus(contractAddress);

Funding a contract

There are several steps that need to be completed in order to build a valid funding transaction, which are outlined in the example below. After following these steps, a completed funding transaction can be submitted to the settlement service so that it can be automatically redeemed.

// STEPS:
// 1. Determine who the parties to the contract will be.
// 2. Determine what unspent coins the parties will use.
// 3. Craft a transaction with the following outputs covered
//     - funding satoshis (short input + long input + miner cost (~1500) + dust cost (1092))
//       to the contract's address.
//     - fee satoshis to pay for the automated settlement service
//       (fee rate and address are returned in the initial registration call)
// 4. Pass the transaction to each party for signing.

// Submit the funding transaction to the settlement service
const fundingInformation = await manager.submitFundingTransaction(contractAddress, constructedTransactionHex);

Retrieving a contract's fundings

A contract can be funded in multiple separate instances. Retrieve a list of the contract's fundings:

const fundings = await manager.getContractFundings(contractData.parameters);

Manually redeeming a contract

If you need to, you can mature or liquidate a contract funding manually:

Note that this is not necessary if you are using a redemption service as above.

// Mature a contract funding.
const maturationResult = await manager.matureContractFunding(...parameters);

// Liquidate a contract funding.
const liquidationResult = await manager.liquidateContractFunding(...parameters);

Mutual redemption of a contract

Also if needed, you can mutually redeem a contract by agreement between Short and Long in several ways:

Non-custodial mutual redemption

Usually, both parties of the contract are separate entities that do not wish to share their private keys. So in order to mutually redeem a contract in a non-custodial way, both parties need to sign a transaction separately.

Mutual refund

In a mutual refund, both parties agree to send the initial input amounts back to both parties.

// Sign a mutual refund proposal on the short's side.
const shortProposal = await manager.signMutualRefund(...parameters);

// Sign a mutual refund proposal on the long's side.
const longProposal = await manager.signMutualRefund(...parameters);

// Complete the mutual redemption and broadcast the transaction.
const refundTransaction = await manager.completeMutualRedemption(shortProposal, longProposal, contractData.parameters);
Mutual early maturation

In a mutual early maturation, both parties agree to mimic the behavior of a maturation, but at an arbitrary time.

// Sign a mutual early maturation proposal on the short's side.
const shortProposal = await manager.signMutualEarlyMaturation(...parameters);

// Sign a mutual early maturation proposal on the long's side.
const longProposal = await manager.signMutualEarlyMaturation(...parameters);

// Complete the mutual redemption and broadcast the transaction.
const earlyMaturationTransaction = await manager.completeMutualRedemption(shortProposal, longProposal, contractData.parameters);
Mutual arbitrary payout

In a mutual arbitrary payout, both parties agree to any arbitrary transaction proposal, which can include arbitrary inputs, outputs and locktime.

// Sign a mutual early maturation proposal on the short's side.
const shortProposal = await manager.signMutualArbitraryPayout(...parameters);

// Sign a mutual early maturation proposal on the long's side.
const longProposal = await manager.signMutualArbitraryPayout(...parameters);

// Complete the mutual redemption and broadcast the transaction.
const arbitraryPayoutTransaction = await manager.completeMutualRedemption(shortProposal, longProposal, contractData.parameters);

Custodial mutual redemption

If you have access to the private keys of both parties of the contract, you can also mutually redeem the contract by providing both private keys:

  • Perform a refund to return the original input amounts to their owners.
  • Perform an early maturation that mimics the behavior of a regular maturation, but an arbitrary time.
  • Perform an arbitrary payout that can include arbitrary transaction details.
// Refund both parties' initial inputs.
const refundTransaction = await manager.custodialMutualRefund(...parameters);

// Perform an early maturation.
const earlyMaturationTransaction = await manager.custodialMutualEarlyMaturation(...parameters);

// Perform an arbitrary payout transaction.
const arbitraryPayoutTransaction = await manager.custodialMutualArbitraryPayout(...parameters);