@lombard.finance/sdk-starknet 0.3.0-canary.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Lombard Finance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+# @lombard.finance/sdk-starknet
+
+The Lombard's Starknet SDK package provides a set of functions that allow interacting with the Lombard protocol and its features.
+
+Read more about Lombard's mission: https://www.lombard.finance
+
+**⚠️ THIS PACKAGE IS EXPERIMENTAL USE AT YOUR OWN RISK!**
+
+## Installation
+
+### Installing per dependencies
+
+```
+npm install @noble/hashes@^1.7.2 axios@^1 bignumber.js@^9
+```
+
+### Installing SDK
+
+```
+npm install @lombard.finance/sdk-common@^3.3.0 @lombard.finance/sdk@^3.6.0 @lombard.finance/sdk-starknet
+```
+
+## Usage
+
+### Getting or generating the BTC deposit address
+
+```javascript
+import {
+  Env,
+  generateDepositBtcAddress,
+  getDepositBtcAddress,
+} from '@lombard.finance/sdk';
+import { signLbtcDestinationAddrStarknet } from '@lombard.finance/sdk-starknet';
+
+let depositAddress = await getDepositBtcAddress({
+  address: walletAccount.address, // connected wallet address,
+  chainId: StarknetChainId.SN_SEPOLIA, // the chain identifier, other available options are: StarknetChainId.SN_MAIN
+  env: Env.stage, // the environment, use Env.stage for StarknetChainId.SN_SEPOLIA testing,
+  partnerId: ENV_PARTNER_ID, // your partner id
+});
+
+if (!depositAddress) {
+  // Step 1: sign destination address
+  const sig = await signLbtcDestinationAddrStarknet({
+    walletAccount: walletAccount, // connected wallet account
+    chainId: StarknetChainId.SN_SEPOLIA, // the chain identifier, other available options are: StarknetChainId.SN_MAIN
+  });
+
+  // Step 2: generate address
+  depositAddress = await generateDepositBtcAddress({
+    address: walletAccount.address, // connected wallet address,
+    chainId: StarknetChainId.SN_SEPOLIA, // the chain identifier, other available options are: StarknetChainId.SN_MAIN
+    signature: sig.signatureHex, // the signature hex from step 1
+    pubKey: sig.pubKey, // the pubkey from step 1
+    env: Env.stage, // the environment, use Env.stage for StarknetChainId.SN_SEPOLIA testing,
+    partnerId: ENV_PARTNER_ID, // your partner id
+  });
+}
+```
+
+### Deposit status
+
+```javascript
+import { getDepositsByAddress } from '@lombard.finance/sdk';
+
+const deposits = await getDepositsByAddress({
+  address: walletAccount.address, // connected wallet address,
+  env: Env.stage, // the environment, use Env.stage for StarknetChainId.SN_SEPOLIA testing,
+});
+```
+
+The above results with an array of:
+
+- `txid: string;` - The BTC transaction id,
+- `index?: number;` - The index of the BTC transaction,
+- `value: BigNumber;` - The deposit amount,
+- `address: Address;` - The source address,
+- `chainId: ChainId | SuiChain | SolanaChain | StarknetChain;` -
+- `isClaimed?: boolean;` - A flag determining whether the particular deposit has been claimed,
+- `claimedTxId?: string;` - The claimed transaction id,
+- `rawPayload?: string;` - The raw deposit payload,
+- `signature?: string;` - The deposit signature,
+- `notarizationWaitDur?: Seconds;` - Approx. number of seconds until notarization completed,
+- `payload?: string;` - The deposit payload,
+- `notarizationStatus: ENotarizationStatus;` - The notarization status.
+
+### Minting LBTC
+
+```javascript
+import { mint, Token } from '@lombard.finance/sdk-starknet';
+
+const mintParams = {
+  amount: d.value, // The deposit amount
+  depositIndex: d.index, // The index of the BTC transaction
+  depositPayload: d.rawPayload, // The raw deposit payload
+  depositProofSignature: d.signature, // The deposit signature
+  depositTxId: d.txid, // The BTC transaction id
+  token: Token.LBTC, // The token identifier
+  walletAccount: walletAccount, // connected wallet account
+};
+
+const txHash = await mint(mintParams);
+```
+
+### Checking the balance of LBTC
+
+```javascript
+import { balanceOf, Token, StarknetChain } from '@lombard.finance/sdk-starknet';
+
+const tokenBalance = await balanceOf({
+  account: walletAccount, // an instance of the WalletAccount class
+  token: Token.LBTC, // the token identifier, other available tokens are: Token.ETH and Token.STRK
+  chainId: StarknetChainId.SN_SEPOLIA, // the chain identifier, other available options are: StarknetChainId.SN_MAIN
+});
+```
+
+### Redeeming LBTC
+
+```javascript
+import { redeem, Token } from '@lombard.finance/sdk-starknet';
+
+const txHash = await redeem({
+  amount: amount, // amount to be redeemed, e.g. `BigNumber(0.02)`
+  btcAddress: btcAddress, // the BTC destination address
+  token: Token.LBTC, // The token identifier
+  walletAccount: walletAccount, // connected wallet account
+});
+```

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index2.cjs");exports.SIGN_MESSAGE_TYPED_DATA=e.SIGN_MESSAGE_TYPED_DATA;exports.StarknetChain=e.StarknetChain;exports.StarknetChainId=e.StarknetChainId;exports.Token=e.Token;exports.approve=e.approve;exports.balanceOf=e.balanceOf;exports.getRpcProvider=e.getRpcProvider;exports.getTokenContract=e.getTokenContract;exports.getTokenInfo=e.getTokenInfo;exports.makeDestinationChainId=e.makeDestinationChainId;exports.mint=e.mint;exports.redeem=e.redeem;exports.signLbtcDestinationAddrStarknet=e.signLbtcDestinationAddrStarknet;exports.signMessage=e.signMessage;exports.signTermsOfService=e.signTermsOfService;exports.starknetModule=e.starknetModule;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,20 @@
+import { S as s, b as n, c as t, T as i, d as r, e as o, f as k, h as d, i as S, m as g, j as T, k as c, s as m, l as f, n as h, o as p } from "./index2.js";
+export {
+  s as SIGN_MESSAGE_TYPED_DATA,
+  n as StarknetChain,
+  t as StarknetChainId,
+  i as Token,
+  r as approve,
+  o as balanceOf,
+  k as getRpcProvider,
+  d as getTokenContract,
+  S as getTokenInfo,
+  g as makeDestinationChainId,
+  T as mint,
+  c as redeem,
+  m as signLbtcDestinationAddrStarknet,
+  f as signMessage,
+  h as signTermsOfService,
+  p as starknetModule
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}