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

@marinade.finance/marinade-ts-sdk

v5.0.15

Published

Marinade SDK for Typescript

Downloads

3,415

Readme

marinade-ts-sdk

Marinade.finance is a liquid staking protocol built on Solana. People stake their Solana tokens with Marinade using automatic staking strategies and receive "staked SOL" tokens they can use in the world of DeFi or to swap any time back to original SOL tokens to unstake.

This SDK wraps the staking protocol and allows you to start marinading from your applications.

Build

Contents:

Installation

$ npm install @marinade.finance/marinade-ts-sdk

Examples

Initialize the library

  1. Use the default configuration (with Solana devnet):
import { Marinade } from '@marinade.finance/marinade-ts-sdk'

const marinade = new Marinade()

or using plain HTML (do not forget to replace <VERSION>):

<script src='https://github.com/marinade-finance/marinade-ts-sdk/releases/download/<VERSION>/marinade-ts-sdk.min.js'></script>
<script>
  const { Marinade } = MarinadeSdk
  const marinade = new Marinade()
</script>
  1. Extend your configuration with other options:
import { Marinade, MarinadeConfig, Wallet, Provider } from '@marinade.finance/marinade-ts-sdk'

const config = new MarinadeConfig({
  connection: currentConnection,
  publicKey: wallet.pubKey
})
const marinade = new Marinade(config)
  1. When you use the referral code, staking/unstaking functions are run against the Marinade Referral Program.
import { Marinade, MarinadeConfig } from '@marinade.finance/marinade-ts-sdk'

const MY_REFERRAL_ACCOUNT = "...." // <-- your referral account
const config = new MarinadeConfig({
  connection: currentConnection,
  publicKey: wallet.pubKey,
  referralCode: new web3.PublicKey(MY_REFERRAL_ACCOUNT),
})
const marinade = new Marinade(config)

Staking

Stake SOL and get your mSOL:

...
const {
  associatedMSolTokenAccountAddress,
  transaction,
} = await marinade.deposit(amountLamports)
// sign and send the `transaction`
const signature = await provider.send(transaction)

Swap your mSOL to get back SOL immediately using the liquidity pool:

...
const {
  associatedMSolTokenAccountAddress,
  transaction,
} = await marinade.liquidUnstake(amountLamports)
// sign and send the `transaction`
const signature = await provider.send(transaction)

Marinade Native Staking

You can now stake assets in Marinade Native through the SDK, either with or without a referral code.

Stake without referral code

If you choose to stake without a referral code, the methods exposed in marinade-native-stake.ts serve as wrappers for those already detailed in the Native Stake SDK. Please note that staking without a referral code will yield only Transaction Instructions.

Stake with referral code

To acquire a referral code, you'll need to visit the Marinade dApp to retrieve it. Once you have the code, you can input it into the methods described below. Please note that the method returns a Versioned Transaction.

Stake SOL to Marinade Native

...
const versionedTransaction = await getRefNativeStakeSOLTx(userPublicKey, amountLamports, refCode)
// sign and send the `transaction`
const signature = await wallet.sendTransaction(unsignedTx, connection)

Deposit Stake Account to Marinade Native

...
const versionedTransaction = await getRefNativeStakeAccountTx(userPublicKey, stakeAccountAddress, refCode)
// sign and send the `transaction`
const signature = await wallet.sendTransaction(versionedTransaction, connection)

Prepare for Unstake from Marinade Native

To initiate the process of unstaking, you'll need to merge your stake accounts back into a single account and pay the associated fee (in SOL). To do this, execute the following command:

...
const transaction = new Transaction()
const prepareUnstakeIx = await getPrepareNativeUnstakeSOLIx(userPublicKey, amountLamports)
transaction.add(...prepareUnstakeIx.payFees)
// sign and send the `transaction`
const signature = await wallet.sendTransaction(transaction, connection)
await authIx.onPaid()

Liquidity pool

Add liquidity to the liquidity pool and receive LP tokens:

...
const {
  associatedLPTokenAccountAddress,
  transaction,
} = await marinade.addLiquidity(amountLamports)
// sign and send the `transaction`
const signature = await provider.send(transaction)

Burn LP tokens and get SOL and mSOL back from the liquidity pool:

...
const {
  associatedLPTokenAccountAddress,
  associatedMSolTokenAccountAddress,
  transaction,
} = await marinade.removeLiquidity(amountLamports)
// sign and send the `transaction`
const signature = await provider.send(transaction)

For more examples have a look at Marinade TS CLI

Learn more

Marinade Lookup Table

Marinade lookup table address: DCcQeBaCiYsEsjjmEsSYPCr9o4n174LKqXNDvQT5wVd8

solana address-lookup-table --keypair ...
solana address-lookup-table extend --keypair ... DCcQeBaCiYsEsjjmEsSYPCr9o4n174LKqXNDvQT5wVd8 --addresses \
11111111111111111111111111111111,\
TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA,\
SysvarC1ock11111111111111111111111111111111,\
SysvarRent111111111111111111111111111111111,\
Stake11111111111111111111111111111111111111,\
MarBmsSgKXdrN1egZf5sqe1TMai9K1rChYNDJgjq7aD,\
8szGkuLTAux9XMgZ2vtY39jVSowEcpBfFfD8hXSEqdGC,\
mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So,\
UefNb6z6yvArqe4cJHTXCqStRsKmWhGxnZzuHbikP5Q,\
7GgPYjS5Dza89wV6FpZ23kUJRG5vbQ1GM25ezspYFSoE,\
EyaSjUtSgo9aRD1f8LWXwdvkpDTmXAW54yoSHZRF14WL,\
Du3Ysj1wKbxPKkuPPnvzQLQh8oMSVifs3jGZjJWXFmHN,\
3JLPCS1qM2zRw3Dp6V4hZnYHd4toMNPkNesXdX9tg6KM,\
Anv3XE7e5saNdm16MU6bniYS59Mpv7DzQXHAhxJUmAKW,\
DwFYJNnhLmw19FBTrVaLWZ8SZJpxdPoSYVSJaio9tjbY,\
J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn,\
Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb,\
Bcr3rbZq1g7FsPz8tawDzT6fCzN1pvADthcv3CtTpd3b,\
MariuAU5bpAbmyX21J2igSHTRF3Ah4GyERRfDBwrPYo,\
D8cy77BBepLMngZx6ZukaTff5hCt1HrWyKk3Hnd9oitf,\
9Ed78GzZrHN61XH9CkcMHFrkSMD88sPWVJCvjres46cT,\
GWvyD94pBVHqV7swFG6ASwD8BHeyeumonQ1yv6qEt3ce,\
CnUPHtfUVw3D2s4FB8H6QBuLwoes8YxauVgDtFybm7rz,\
dsNNp4g7NUv4u7GA8GqfMPCCPPxYdHk8vypbp2fbkiC,\
A8kEy5wWgdW4FG593fQJ5QPVbqx1wkfXw9c4L9bPo2CN,\
9nnLbotNTcUhvbrsA6Mdkx45Sm82G35zo28AqUvjExn8,\
So11111111111111111111111111111111111111112,\
AGcY7eBWGuLJVWc8HdamDZHBPQCn8K4ydB8pafEkcQz3,\
GkSKNXhfvhqpCrF2BqjMKoaczRXQSc8pVJai7qkmhx9V,\
JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4,\
FhLPkpFmszHtSyyayj7KsXNZeBTqfQbUPmvgWAyJHBXh,\
HxTk98CmBcxmtkrBWqRszYxrnDpqAsbitQBc2QjVBG3j,\
Dy1zNe9eqoTtVBjUbkunuJ8fFbHsMBdMxFemerFWAsKy,\
HtncvpUBGhSrs48KtC58ntJcTDw53sn78Lpq71zVwiez,\
GN3KFotCLCme8na7CTdCR9Wy6CTxHmjmHvXaLnNRKabZ,\
4VKKMz4XCyHkRYy86tGRF9ninmwVCHdxdk3dRjY3WGxc