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

@cardstack/cardpay-sdk

v1.0.54

Published

An SDK for using the cardpay protocol

Downloads

596

Readme

cardpay-sdk

This is a package that provides an SDK to use the Cardpay protocol. The SDK is divided into two main parts currently Cardpay and Champer. See here for full documentation

Champer

Champer is the newer part of the SDK that interact with our safe modules.

Cardpay

Cardpay is the older part of the SDK that interact with our protocol smart contracts and token bridge.

  • Assets: Utility to query native and ERC20 token balances

  • Safes: Utility to query safes in our protocol

  • LayerOneOracle: Utility to get the current exchange rates in USD and ETH on layer 1

  • LayerTwoOracle: Utility get the current exchange rates in USD and ETH on layer 2

  • TokenBridgeForeignSide: Interact with the foreign-side bridge ie the bridge contract receiving the tokens on layer 1

  • TokenBridgeHomeSide: Interact with the home-side bridge ie the bridge contract minting the tokens on layer 2

  • PrepaidCard: Create and interact with prepaid cards that are used to pay merchants

  • RevenuePool: Register merchants and claim revenue

  • PrepaidCardMarket: Provision prepaid cards to people who buy them

  • PrepaidCardMarketV2: Similar as PrepaidCardMarket but using updated v2 pattern where prepaid cards are provisioned before being created

  • RewardManager: Register and manage reward program

  • RewardPool: Submit rewards with merkle roots and claim rewards as a user

Installation

yarn add @cardstack/cardpay-sdk

Usage

yarn add @cardstack/[email protected] [email protected] [email protected]
import fetch from "node-fetch";
import { getSDK, JsonRpcProvider } from "@cardstack/cardpay-sdk";
import { Wallet } from "ethers";

//@ts-ignore polyfilling fetch
global.fetch = fetch;

(async () => {
  const mnemonic =
    "<Your mnemonic>";
  const signer = Wallet.fromMnemonic(mnemonic);
  const rpcUrl = "https://eth-goerli.public.blastapi.io";
  const networkId = 5; // 5 for goerli
  const ethersProvider = new JsonRpcProvider(rpcUrl, networkId);
  const scheduledPaymentModule = await getSDK(
    "ScheduledPaymentModule",
    ethersProvider,
    signer
  );
  const { safeAddress } =
    await scheduledPaymentModule.createSafeWithModuleAndGuard(
      undefined,
      undefined,
      { from: signer.address }
    );
  console.log(`Your new safe ${safeAddress} has been created`);
})();

Special Considerations

One item to note that all token amounts that are provided to the API must strings and be in native units of the token (usually wei) unless otherwise noted. All token amounts returned by the API will also be in native units (again, this usually means wei). You can use Web3.utils.toWei() and Web3.utils.fromWei() to convert to and from units of wei. Because ethereum numbers can be so large, it is unsafe to represent these natively in Javascript, and in fact it is very common for a smart contract to return numbers that are simply too large to be represented natively in Javascript. For this reason, within Javascript the only safe way to natively handle numbers coming from Ethereum is as a string. If you need to perform math on a number coming from Ethereum use the BigNumber feature of the ethers library.