@leather.io/stacks 1.4.0 → 1.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +59 -59
- package/dist/index.js +45 -43
- package/dist/index.js.map +1 -1
- package/package.json +5 -5
package/dist/index.d.ts
CHANGED
|
@@ -1,63 +1,9 @@
|
|
|
1
1
|
import * as _stacks_transactions from '@stacks/transactions';
|
|
2
|
-
import {
|
|
3
|
-
import { HDKey } from '@scure/bip32';
|
|
4
|
-
import { NetworkModes, ReplaceTypes, Money } from '@leather.io/models';
|
|
2
|
+
import { StacksTransaction, UnsignedContractCallOptions, UnsignedContractDeployOptions, UnsignedTokenTransferOptions, PostCondition, ChainID, StacksPrivateKey, ClarityValue } from '@stacks/transactions';
|
|
5
3
|
import { Signer } from '@leather.io/crypto';
|
|
4
|
+
import { NetworkModes, ReplaceTypes, Money } from '@leather.io/models';
|
|
6
5
|
import BigNumber from 'bignumber.js';
|
|
7
|
-
|
|
8
|
-
declare const stxDerivationWithAccount = "m/44'/5757'/0'/0/{account}";
|
|
9
|
-
declare function makeAccountIndexDerivationPathFactory(derivationPath: string): (account: number) => string;
|
|
10
|
-
declare function extractStacksDerivationPathAccountIndex(path: string): number;
|
|
11
|
-
/**
|
|
12
|
-
* Stacks accounts always use the same derivation path, regardless of network
|
|
13
|
-
*/
|
|
14
|
-
declare const makeStxDerivationPath: (account: number) => string;
|
|
15
|
-
declare function stacksChainIdToCoreNetworkMode(chainId: ChainID): NetworkModes;
|
|
16
|
-
interface WhenStacksChainIdMap<T> {
|
|
17
|
-
[ChainID.Mainnet]: T;
|
|
18
|
-
[ChainID.Testnet]: T;
|
|
19
|
-
}
|
|
20
|
-
declare function whenStacksChainId(chainId: ChainID): <T>(chainIdMap: WhenStacksChainIdMap<T>) => T;
|
|
21
|
-
declare function deriveStxPrivateKey({ keychain, index }: {
|
|
22
|
-
keychain: HDKey;
|
|
23
|
-
index: number;
|
|
24
|
-
}): string;
|
|
25
|
-
declare function deriveStxPublicKey({ keychain, index }: {
|
|
26
|
-
keychain: HDKey;
|
|
27
|
-
index: number;
|
|
28
|
-
}): _stacks_transactions.StacksPublicKey;
|
|
29
|
-
declare function stacksRootKeychainToAccountDescriptor(keychain: HDKey, accountIndex: number): string;
|
|
30
|
-
declare function getStacksBurnAddress(chainId: ChainID): string;
|
|
31
|
-
declare function cleanHex(hexWithMaybePrefix: string): string;
|
|
32
|
-
/**
|
|
33
|
-
* Gets the contract name of a fully qualified name of an asset.
|
|
34
|
-
*
|
|
35
|
-
* @param contractId - the source string: [principal].[contract-name] or [principal].[contract-name]::[asset-name]
|
|
36
|
-
*/
|
|
37
|
-
declare function getStacksContractName(contractId: string): string;
|
|
38
|
-
/**
|
|
39
|
-
* Gets the asset name from a a fully qualified name of an asset.
|
|
40
|
-
*
|
|
41
|
-
* @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]
|
|
42
|
-
*/
|
|
43
|
-
declare function getStacksContractAssetName(contractId: string): string;
|
|
44
|
-
/**
|
|
45
|
-
* Gets the parts that make up a fully qualified name of an asset.
|
|
46
|
-
*
|
|
47
|
-
* @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]
|
|
48
|
-
*/
|
|
49
|
-
declare function getStacksContractIdStringParts(contractId: string): {
|
|
50
|
-
contractAddress: string;
|
|
51
|
-
contractAssetName: string;
|
|
52
|
-
contractName: string;
|
|
53
|
-
};
|
|
54
|
-
|
|
55
|
-
interface SignatureData {
|
|
56
|
-
signature: string;
|
|
57
|
-
publicKey: string;
|
|
58
|
-
}
|
|
59
|
-
declare function signMessage(message: string, privateKey: StacksPrivateKey): SignatureData;
|
|
60
|
-
declare function signStructuredDataMessage(message: ClarityValue, domain: ClarityValue, privateKey: StacksPrivateKey): SignatureData;
|
|
6
|
+
import { HDKey } from '@scure/bip32';
|
|
61
7
|
|
|
62
8
|
declare function signStacksTransaction(tx: StacksTransaction, privateKey: string): StacksTransaction;
|
|
63
9
|
type StacksSignerFn = (tx: StacksTransaction) => Promise<StacksTransaction>;
|
|
@@ -112,10 +58,64 @@ declare function initNonce(nonce: number | string): BigNumber;
|
|
|
112
58
|
declare function generateUnsignedContractCall(options: StacksUnsignedContractCallOptions): Promise<_stacks_transactions.StacksTransaction>;
|
|
113
59
|
declare function generateUnsignedContractDeploy(options: StacksUnsignedContractDeployOptions): Promise<_stacks_transactions.StacksTransaction>;
|
|
114
60
|
declare function generateUnsignedStxTokenTransfer(options: StacksUnsignedTokenTransferOptions): Promise<_stacks_transactions.StacksTransaction>;
|
|
115
|
-
declare function
|
|
61
|
+
declare function generateStacksUnsignedTransaction(options: StacksUnsignedTransactionOptions): Promise<_stacks_transactions.StacksTransaction>;
|
|
116
62
|
|
|
117
63
|
declare function getPostConditionFromString(postCondition: string): PostCondition;
|
|
118
64
|
declare function getPostCondition(postCondition: string | PostCondition): PostCondition;
|
|
119
65
|
declare function getPostConditions(postConditions?: (string | PostCondition)[]): PostCondition[] | undefined;
|
|
120
66
|
|
|
121
|
-
|
|
67
|
+
declare const stxDerivationWithAccount = "m/44'/5757'/0'/0/{account}";
|
|
68
|
+
declare function makeAccountIndexDerivationPathFactory(derivationPath: string): (account: number) => string;
|
|
69
|
+
declare function extractStacksDerivationPathAccountIndex(path: string): number;
|
|
70
|
+
/**
|
|
71
|
+
* Stacks accounts always use the same derivation path, regardless of network
|
|
72
|
+
*/
|
|
73
|
+
declare const makeStxDerivationPath: (account: number) => string;
|
|
74
|
+
declare function stacksChainIdToCoreNetworkMode(chainId: ChainID): NetworkModes;
|
|
75
|
+
interface WhenStacksChainIdMap<T> {
|
|
76
|
+
[ChainID.Mainnet]: T;
|
|
77
|
+
[ChainID.Testnet]: T;
|
|
78
|
+
}
|
|
79
|
+
declare function whenStacksChainId(chainId: ChainID): <T>(chainIdMap: WhenStacksChainIdMap<T>) => T;
|
|
80
|
+
declare function deriveStxPrivateKey({ keychain, index }: {
|
|
81
|
+
keychain: HDKey;
|
|
82
|
+
index: number;
|
|
83
|
+
}): string;
|
|
84
|
+
declare function deriveStxPublicKey({ keychain, index }: {
|
|
85
|
+
keychain: HDKey;
|
|
86
|
+
index: number;
|
|
87
|
+
}): _stacks_transactions.StacksPublicKey;
|
|
88
|
+
declare function stacksRootKeychainToAccountDescriptor(keychain: HDKey, accountIndex: number): string;
|
|
89
|
+
declare function getStacksBurnAddress(chainId: ChainID): string;
|
|
90
|
+
declare function cleanHex(hexWithMaybePrefix: string): string;
|
|
91
|
+
/**
|
|
92
|
+
* Gets the contract name of a fully qualified name of an asset.
|
|
93
|
+
*
|
|
94
|
+
* @param contractId - the source string: [principal].[contract-name] or [principal].[contract-name]::[asset-name]
|
|
95
|
+
*/
|
|
96
|
+
declare function getStacksContractName(contractId: string): string;
|
|
97
|
+
/**
|
|
98
|
+
* Gets the asset name from a a fully qualified name of an asset.
|
|
99
|
+
*
|
|
100
|
+
* @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]
|
|
101
|
+
*/
|
|
102
|
+
declare function getStacksContractAssetName(contractId: string): string;
|
|
103
|
+
/**
|
|
104
|
+
* Gets the parts that make up a fully qualified name of an asset.
|
|
105
|
+
*
|
|
106
|
+
* @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]
|
|
107
|
+
*/
|
|
108
|
+
declare function getStacksContractIdStringParts(contractId: string): {
|
|
109
|
+
contractAddress: string;
|
|
110
|
+
contractAssetName: string;
|
|
111
|
+
contractName: string;
|
|
112
|
+
};
|
|
113
|
+
|
|
114
|
+
interface SignatureData {
|
|
115
|
+
signature: string;
|
|
116
|
+
publicKey: string;
|
|
117
|
+
}
|
|
118
|
+
declare function signMessage(message: string, privateKey: StacksPrivateKey): SignatureData;
|
|
119
|
+
declare function signStructuredDataMessage(message: ClarityValue, domain: ClarityValue, privateKey: StacksPrivateKey): SignatureData;
|
|
120
|
+
|
|
121
|
+
export { type StacksSigner, type StacksSignerFn, type StacksUnsignedContractCallOptions, type StacksUnsignedContractDeployOptions, type StacksUnsignedTokenTransferOptions, type StacksUnsignedTransactionOptions, TransactionTypes, cleanHex, createSignFnFromMnemonic, deriveStxPrivateKey, deriveStxPublicKey, extractStacksDerivationPathAccountIndex, generateStacksUnsignedTransaction, generateUnsignedContractCall, generateUnsignedContractDeploy, generateUnsignedStxTokenTransfer, getPostCondition, getPostConditionFromString, getPostConditions, getStacksBurnAddress, getStacksContractAssetName, getStacksContractIdStringParts, getStacksContractName, initNonce, initalizeStacksSigner, isTransactionTypeSupported, makeAccountIndexDerivationPathFactory, makeStxDerivationPath, signMessage, signStacksTransaction, signStructuredDataMessage, stacksChainIdToCoreNetworkMode, stacksRootKeychainToAccountDescriptor, stxDerivationWithAccount, whenStacksChainId };
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,18 @@
|
|
|
1
|
+
// src/signer/signer.ts
|
|
2
|
+
import {
|
|
3
|
+
AddressVersion,
|
|
4
|
+
TransactionSigner,
|
|
5
|
+
createStacksPrivateKey as createStacksPrivateKey2,
|
|
6
|
+
createStacksPublicKey,
|
|
7
|
+
publicKeyToAddress
|
|
8
|
+
} from "@stacks/transactions";
|
|
9
|
+
import {
|
|
10
|
+
decomposeDescriptor,
|
|
11
|
+
deriveRootKeychainFromMnemonic,
|
|
12
|
+
extractKeyFromDescriptor
|
|
13
|
+
} from "@leather.io/crypto";
|
|
14
|
+
import { whenNetwork } from "@leather.io/utils";
|
|
15
|
+
|
|
1
16
|
// src/stacks.utils.ts
|
|
2
17
|
import { bytesToHex } from "@noble/hashes/utils";
|
|
3
18
|
import { compressPrivateKey } from "@stacks/encryption";
|
|
@@ -86,48 +101,7 @@ function getStacksContractIdStringParts(contractId) {
|
|
|
86
101
|
};
|
|
87
102
|
}
|
|
88
103
|
|
|
89
|
-
// src/message-signing.ts
|
|
90
|
-
import { bytesToHex as bytesToHex2 } from "@noble/hashes/utils";
|
|
91
|
-
import { hashMessage } from "@stacks/encryption";
|
|
92
|
-
import {
|
|
93
|
-
getPublicKey as getPublicKey2,
|
|
94
|
-
publicKeyToString,
|
|
95
|
-
signMessageHashRsv,
|
|
96
|
-
signStructuredData
|
|
97
|
-
} from "@stacks/transactions";
|
|
98
|
-
function signMessage(message, privateKey) {
|
|
99
|
-
const hash = hashMessage(message);
|
|
100
|
-
return {
|
|
101
|
-
signature: signMessageHashRsv({ privateKey, messageHash: bytesToHex2(hash) }).data,
|
|
102
|
-
publicKey: publicKeyToString(getPublicKey2(privateKey))
|
|
103
|
-
};
|
|
104
|
-
}
|
|
105
|
-
function signStructuredDataMessage(message, domain, privateKey) {
|
|
106
|
-
const signature = signStructuredData({
|
|
107
|
-
message,
|
|
108
|
-
domain,
|
|
109
|
-
privateKey
|
|
110
|
-
}).data;
|
|
111
|
-
return {
|
|
112
|
-
signature,
|
|
113
|
-
publicKey: publicKeyToString(getPublicKey2(privateKey))
|
|
114
|
-
};
|
|
115
|
-
}
|
|
116
|
-
|
|
117
104
|
// src/signer/signer.ts
|
|
118
|
-
import {
|
|
119
|
-
AddressVersion,
|
|
120
|
-
TransactionSigner,
|
|
121
|
-
createStacksPrivateKey as createStacksPrivateKey2,
|
|
122
|
-
createStacksPublicKey,
|
|
123
|
-
publicKeyToAddress
|
|
124
|
-
} from "@stacks/transactions";
|
|
125
|
-
import {
|
|
126
|
-
decomposeDescriptor,
|
|
127
|
-
deriveRootKeychainFromMnemonic,
|
|
128
|
-
extractKeyFromDescriptor
|
|
129
|
-
} from "@leather.io/crypto";
|
|
130
|
-
import { whenNetwork } from "@leather.io/utils";
|
|
131
105
|
function signStacksTransaction(tx, privateKey) {
|
|
132
106
|
const signer = new TransactionSigner(tx);
|
|
133
107
|
signer.signOrigin(createStacksPrivateKey2(privateKey));
|
|
@@ -237,7 +211,7 @@ function generateUnsignedStxTokenTransfer(options) {
|
|
|
237
211
|
};
|
|
238
212
|
return makeUnsignedSTXTokenTransfer({ ...options, ...parsedOptions });
|
|
239
213
|
}
|
|
240
|
-
async function
|
|
214
|
+
async function generateStacksUnsignedTransaction(options) {
|
|
241
215
|
const isValid = isTransactionTypeSupported(options.txType);
|
|
242
216
|
if (!isValid) throw new Error(`Invalid Transaction Type: ${options.txType}`);
|
|
243
217
|
switch (options.txType) {
|
|
@@ -249,6 +223,34 @@ async function generateUnsignedTransaction(options) {
|
|
|
249
223
|
return generateUnsignedContractDeploy(options);
|
|
250
224
|
}
|
|
251
225
|
}
|
|
226
|
+
|
|
227
|
+
// src/message-signing.ts
|
|
228
|
+
import { bytesToHex as bytesToHex2 } from "@noble/hashes/utils";
|
|
229
|
+
import { hashMessage } from "@stacks/encryption";
|
|
230
|
+
import {
|
|
231
|
+
getPublicKey as getPublicKey2,
|
|
232
|
+
publicKeyToString,
|
|
233
|
+
signMessageHashRsv,
|
|
234
|
+
signStructuredData
|
|
235
|
+
} from "@stacks/transactions";
|
|
236
|
+
function signMessage(message, privateKey) {
|
|
237
|
+
const hash = hashMessage(message);
|
|
238
|
+
return {
|
|
239
|
+
signature: signMessageHashRsv({ privateKey, messageHash: bytesToHex2(hash) }).data,
|
|
240
|
+
publicKey: publicKeyToString(getPublicKey2(privateKey))
|
|
241
|
+
};
|
|
242
|
+
}
|
|
243
|
+
function signStructuredDataMessage(message, domain, privateKey) {
|
|
244
|
+
const signature = signStructuredData({
|
|
245
|
+
message,
|
|
246
|
+
domain,
|
|
247
|
+
privateKey
|
|
248
|
+
}).data;
|
|
249
|
+
return {
|
|
250
|
+
signature,
|
|
251
|
+
publicKey: publicKeyToString(getPublicKey2(privateKey))
|
|
252
|
+
};
|
|
253
|
+
}
|
|
252
254
|
export {
|
|
253
255
|
TransactionTypes,
|
|
254
256
|
cleanHex,
|
|
@@ -256,10 +258,10 @@ export {
|
|
|
256
258
|
deriveStxPrivateKey,
|
|
257
259
|
deriveStxPublicKey,
|
|
258
260
|
extractStacksDerivationPathAccountIndex,
|
|
261
|
+
generateStacksUnsignedTransaction,
|
|
259
262
|
generateUnsignedContractCall,
|
|
260
263
|
generateUnsignedContractDeploy,
|
|
261
264
|
generateUnsignedStxTokenTransfer,
|
|
262
|
-
generateUnsignedTransaction,
|
|
263
265
|
getPostCondition,
|
|
264
266
|
getPostConditionFromString,
|
|
265
267
|
getPostConditions,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/stacks.utils.ts","../src/message-signing.ts","../src/signer/signer.ts","../src/transactions/generate-unsigned-transaction.ts","../src/transactions/post-condition.utils.ts","../src/transactions/transaction.types.ts"],"sourcesContent":["import { bytesToHex } from '@noble/hashes/utils';\nimport { HDKey } from '@scure/bip32';\nimport { compressPrivateKey } from '@stacks/encryption';\nimport { ChainID, createStacksPrivateKey, getPublicKey } from '@stacks/transactions';\n\nimport {\n DerivationPathDepth,\n createDescriptor,\n createKeyOriginPath,\n extractAddressIndexFromPath,\n} from '@leather.io/crypto';\nimport type { NetworkModes } from '@leather.io/models';\nimport { assertIsTruthy, isString, toHexString } from '@leather.io/utils';\n\nexport const stxDerivationWithAccount = `m/44'/5757'/0'/0/{account}`;\n\nexport function makeAccountIndexDerivationPathFactory(derivationPath: string) {\n return (account: number) => derivationPath.replace('{account}', account.toString());\n}\n\nexport function extractStacksDerivationPathAccountIndex(path: string) {\n if (!path.includes('5757')) throw new Error('Not a valid Stacks derivation path: ' + path);\n return extractAddressIndexFromPath(path);\n}\n\n/**\n * Stacks accounts always use the same derivation path, regardless of network\n */\nexport const makeStxDerivationPath =\n makeAccountIndexDerivationPathFactory(stxDerivationWithAccount);\n\nexport function stacksChainIdToCoreNetworkMode(chainId: ChainID): NetworkModes {\n return whenStacksChainId(chainId)({ [ChainID.Mainnet]: 'mainnet', [ChainID.Testnet]: 'testnet' });\n}\n\ninterface WhenStacksChainIdMap<T> {\n [ChainID.Mainnet]: T;\n [ChainID.Testnet]: T;\n}\nexport function whenStacksChainId(chainId: ChainID) {\n return <T>(chainIdMap: WhenStacksChainIdMap<T>): T => chainIdMap[chainId];\n}\n\n// From `@stacks/wallet-sdk` package we are trying not to use\nexport function deriveStxPrivateKey({ keychain, index }: { keychain: HDKey; index: number }) {\n if (keychain.depth !== DerivationPathDepth.Root) throw new Error('Root keychain must be depth 0');\n const accountKeychain = keychain.derive(makeStxDerivationPath(index));\n assertIsTruthy(accountKeychain.privateKey);\n return bytesToHex(compressPrivateKey(accountKeychain.privateKey));\n}\n\nexport function deriveStxPublicKey({ keychain, index }: { keychain: HDKey; index: number }) {\n return getPublicKey(createStacksPrivateKey(deriveStxPrivateKey({ keychain, index })));\n}\n\nexport function stacksRootKeychainToAccountDescriptor(keychain: HDKey, accountIndex: number) {\n const fingerprint = toHexString(keychain.fingerprint);\n const publicKey = deriveStxPublicKey({ keychain, index: accountIndex });\n return createDescriptor(\n createKeyOriginPath(fingerprint, makeStxDerivationPath(accountIndex)),\n bytesToHex(publicKey.data)\n );\n}\n\nexport function getStacksBurnAddress(chainId: ChainID): string {\n switch (chainId) {\n case ChainID.Mainnet:\n return 'SP00000000000003SCNSJTCSE62ZF4MSE';\n case ChainID.Testnet:\n default:\n return 'ST000000000000000000002AMW42H';\n }\n}\n\nexport function cleanHex(hexWithMaybePrefix: string): string {\n if (!isString(hexWithMaybePrefix)) return hexWithMaybePrefix;\n return hexWithMaybePrefix.startsWith('0x')\n ? hexWithMaybePrefix.replace('0x', '')\n : hexWithMaybePrefix;\n}\n\n/**\n * Gets the contract name of a fully qualified name of an asset.\n *\n * @param contractId - the source string: [principal].[contract-name] or [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractName(contractId: string): string {\n if (contractId.includes('.')) {\n const parts = contractId?.split('.');\n if (contractId.includes('::')) {\n return parts[1].split('::')[0];\n }\n return parts[1];\n }\n return contractId;\n}\n\n/**\n * Gets the asset name from a a fully qualified name of an asset.\n *\n * @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractAssetName(contractId: string): string {\n if (!contractId.includes('::')) return contractId;\n return contractId.split('::')[1];\n}\n\n/**\n * Gets the parts that make up a fully qualified name of an asset.\n *\n * @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractIdStringParts(contractId: string): {\n contractAddress: string;\n contractAssetName: string;\n contractName: string;\n} {\n if (!contractId.includes('.') || !contractId.includes('::')) {\n return {\n contractAddress: contractId,\n contractAssetName: contractId,\n contractName: contractId,\n };\n }\n\n const contractAddress = contractId.split('.')[0];\n const contractAssetName = getStacksContractAssetName(contractId);\n const contractName = getStacksContractName(contractId);\n\n return {\n contractAddress,\n contractAssetName,\n contractName,\n };\n}\n","import { bytesToHex } from '@noble/hashes/utils';\nimport { hashMessage } from '@stacks/encryption';\nimport {\n ClarityValue,\n StacksPrivateKey,\n getPublicKey,\n publicKeyToString,\n signMessageHashRsv,\n signStructuredData,\n} from '@stacks/transactions';\n\ninterface SignatureData {\n signature: string;\n publicKey: string;\n}\n\nexport function signMessage(message: string, privateKey: StacksPrivateKey): SignatureData {\n const hash = hashMessage(message);\n return {\n signature: signMessageHashRsv({ privateKey, messageHash: bytesToHex(hash) }).data,\n publicKey: publicKeyToString(getPublicKey(privateKey)),\n };\n}\n\nexport function signStructuredDataMessage(\n message: ClarityValue,\n domain: ClarityValue,\n privateKey: StacksPrivateKey\n): SignatureData {\n const signature = signStructuredData({\n message,\n domain,\n privateKey,\n }).data;\n\n return {\n signature,\n publicKey: publicKeyToString(getPublicKey(privateKey)),\n };\n}\n","import {\n AddressVersion,\n StacksTransaction,\n TransactionSigner,\n createStacksPrivateKey,\n createStacksPublicKey,\n publicKeyToAddress,\n} from '@stacks/transactions';\n\nimport {\n Signer,\n decomposeDescriptor,\n deriveRootKeychainFromMnemonic,\n extractKeyFromDescriptor,\n} from '@leather.io/crypto';\nimport { NetworkModes } from '@leather.io/models';\nimport { whenNetwork } from '@leather.io/utils';\n\nimport { deriveStxPrivateKey, extractStacksDerivationPathAccountIndex } from '../stacks.utils';\n\n// Warning: mutatitive. Ideally there would be a tx.clone() method\nexport function signStacksTransaction(tx: StacksTransaction, privateKey: string) {\n const signer = new TransactionSigner(tx);\n signer.signOrigin(createStacksPrivateKey(privateKey));\n return tx;\n}\n\nexport type StacksSignerFn = (tx: StacksTransaction) => Promise<StacksTransaction>;\n\nexport interface StacksSigner extends Signer {\n descriptor: string;\n keyOrigin: string;\n address: string;\n accountIndex: number;\n network: NetworkModes;\n sign: StacksSignerFn;\n}\n\nexport function createSignFnFromMnemonic(\n keyOrigin: string,\n getMnemonicFn: () => Promise<{ mnemonic: string; passphrase?: string }>\n) {\n return async (tx: StacksTransaction) => {\n const { mnemonic, passphrase } = await getMnemonicFn();\n const keychain = await deriveRootKeychainFromMnemonic(mnemonic, passphrase);\n const privateKey = deriveStxPrivateKey({\n keychain,\n index: extractStacksDerivationPathAccountIndex(keyOrigin),\n });\n return signStacksTransaction(tx, privateKey);\n };\n}\n\ninterface InitalizeStacksSignerArgs {\n descriptor: string;\n network: NetworkModes;\n signFn: StacksSignerFn;\n}\nexport function initalizeStacksSigner(args: InitalizeStacksSignerArgs): StacksSigner {\n const { descriptor, network, signFn } = args;\n\n const publicKey = createStacksPublicKey(extractKeyFromDescriptor(descriptor));\n\n return {\n ...decomposeDescriptor(descriptor),\n // here we overwrite the accountIndex with the derivation path account index for stx\n accountIndex: extractStacksDerivationPathAccountIndex(descriptor),\n publicKey: publicKey.data,\n network,\n address: publicKeyToAddress(\n whenNetwork(network)({\n mainnet: AddressVersion.MainnetSingleSig,\n testnet: AddressVersion.TestnetSingleSig,\n }),\n publicKey\n ),\n sign: signFn,\n };\n}\n","import { hexToBytes } from '@noble/hashes/utils';\nimport {\n deserializeCV,\n makeUnsignedContractCall,\n makeUnsignedContractDeploy,\n makeUnsignedSTXTokenTransfer,\n} from '@stacks/transactions';\nimport BigNumber from 'bignumber.js';\n\nimport { cleanHex } from '../stacks.utils';\nimport { getPostConditions } from './post-condition.utils';\nimport {\n StacksUnsignedContractCallOptions,\n StacksUnsignedContractDeployOptions,\n StacksUnsignedTokenTransferOptions,\n StacksUnsignedTransactionOptions,\n TransactionTypes,\n isTransactionTypeSupported,\n} from './transaction.types';\n\nexport function initNonce(nonce: number | string) {\n return new BigNumber(nonce, 10);\n}\n\nexport function generateUnsignedContractCall(options: StacksUnsignedContractCallOptions) {\n const { fee, functionArgs, nonce, postConditions } = options;\n\n const fnArgs = functionArgs.map(arg => deserializeCV(hexToBytes(cleanHex(arg))));\n\n const parsedOptions = {\n fee: fee.amount.toString(),\n functionArgs: fnArgs,\n nonce: initNonce(nonce).toString(),\n postConditions: getPostConditions(postConditions),\n };\n\n return makeUnsignedContractCall({ ...options, ...parsedOptions });\n}\n\nexport function generateUnsignedContractDeploy(options: StacksUnsignedContractDeployOptions) {\n const { fee, nonce, postConditions } = options;\n\n const parsedOptions = {\n fee: fee.amount.toString(),\n nonce: initNonce(nonce).toString(),\n postConditions: getPostConditions(postConditions),\n };\n\n return makeUnsignedContractDeploy({ ...options, ...parsedOptions });\n}\n\nexport function generateUnsignedStxTokenTransfer(options: StacksUnsignedTokenTransferOptions) {\n const { amount, fee, nonce } = options;\n\n const parsedOptions = {\n amount: amount.amount.toString(),\n fee: fee.amount.toString(),\n nonce: initNonce(nonce).toString(),\n };\n\n return makeUnsignedSTXTokenTransfer({ ...options, ...parsedOptions });\n}\n\nexport async function generateUnsignedTransaction(options: StacksUnsignedTransactionOptions) {\n const isValid = isTransactionTypeSupported(options.txType);\n\n if (!isValid) throw new Error(`Invalid Transaction Type: ${options.txType}`);\n\n switch (options.txType) {\n case TransactionTypes.StxTokenTransfer:\n return generateUnsignedStxTokenTransfer(options);\n case TransactionTypes.ContractCall:\n return generateUnsignedContractCall(options);\n case TransactionTypes.ContractDeploy:\n return generateUnsignedContractDeploy(options);\n }\n}\n","import { hexToBytes } from '@noble/hashes/utils';\nimport { BytesReader, PostCondition, deserializePostCondition } from '@stacks/transactions';\n\nimport { isString } from '@leather.io/utils';\n\nexport function getPostConditionFromString(postCondition: string): PostCondition {\n try {\n const reader = new BytesReader(hexToBytes(postCondition));\n return deserializePostCondition(reader);\n } catch (err) {\n throw new Error('Not a serialized post condition');\n }\n}\n\nexport function getPostCondition(postCondition: string | PostCondition): PostCondition {\n return isString(postCondition) ? getPostConditionFromString(postCondition) : postCondition;\n}\n\nexport function getPostConditions(\n postConditions?: (string | PostCondition)[]\n): PostCondition[] | undefined {\n return postConditions?.map(getPostCondition);\n}\n","import {\n UnsignedContractCallOptions,\n UnsignedContractDeployOptions,\n UnsignedTokenTransferOptions,\n} from '@stacks/transactions';\n\nimport { Money, ReplaceTypes } from '@leather.io/models';\n\nexport enum TransactionTypes {\n ContractCall = 'contract_call',\n ContractDeploy = 'smart_contract',\n StxTokenTransfer = 'token_transfer',\n}\n\nexport function isTransactionTypeSupported(txType: TransactionTypes) {\n return (\n txType === TransactionTypes.ContractCall ||\n txType === TransactionTypes.ContractDeploy ||\n txType === TransactionTypes.StxTokenTransfer\n );\n}\n\nexport type StacksUnsignedContractCallOptions = ReplaceTypes<\n UnsignedContractCallOptions,\n {\n fee: Money;\n functionArgs: string[];\n nonce: number | string;\n }\n> & { txType: TransactionTypes.ContractCall };\n\nexport type StacksUnsignedContractDeployOptions = ReplaceTypes<\n UnsignedContractDeployOptions,\n {\n fee: Money;\n nonce: number | string;\n }\n> & { txType: TransactionTypes.ContractDeploy };\n\nexport type StacksUnsignedTokenTransferOptions = ReplaceTypes<\n UnsignedTokenTransferOptions,\n {\n amount: Money;\n fee: Money;\n nonce: number | string;\n }\n> & { txType: TransactionTypes.StxTokenTransfer };\n\nexport type StacksUnsignedTransactionOptions =\n | StacksUnsignedContractCallOptions\n | StacksUnsignedContractDeployOptions\n | StacksUnsignedTokenTransferOptions;\n"],"mappings":"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","names":["bytesToHex","getPublicKey","createStacksPrivateKey","createStacksPrivateKey","hexToBytes","isString","TransactionTypes","hexToBytes"]}
|
|
1
|
+
{"version":3,"sources":["../src/signer/signer.ts","../src/stacks.utils.ts","../src/transactions/generate-unsigned-transaction.ts","../src/transactions/post-condition.utils.ts","../src/transactions/transaction.types.ts","../src/message-signing.ts"],"sourcesContent":["import {\n AddressVersion,\n StacksTransaction,\n TransactionSigner,\n createStacksPrivateKey,\n createStacksPublicKey,\n publicKeyToAddress,\n} from '@stacks/transactions';\n\nimport {\n Signer,\n decomposeDescriptor,\n deriveRootKeychainFromMnemonic,\n extractKeyFromDescriptor,\n} from '@leather.io/crypto';\nimport { NetworkModes } from '@leather.io/models';\nimport { whenNetwork } from '@leather.io/utils';\n\nimport { deriveStxPrivateKey, extractStacksDerivationPathAccountIndex } from '../stacks.utils';\n\n// Warning: mutatitive. Ideally there would be a tx.clone() method\nexport function signStacksTransaction(tx: StacksTransaction, privateKey: string) {\n const signer = new TransactionSigner(tx);\n signer.signOrigin(createStacksPrivateKey(privateKey));\n return tx;\n}\n\nexport type StacksSignerFn = (tx: StacksTransaction) => Promise<StacksTransaction>;\n\nexport interface StacksSigner extends Signer {\n descriptor: string;\n keyOrigin: string;\n address: string;\n accountIndex: number;\n network: NetworkModes;\n sign: StacksSignerFn;\n}\n\nexport function createSignFnFromMnemonic(\n keyOrigin: string,\n getMnemonicFn: () => Promise<{ mnemonic: string; passphrase?: string }>\n) {\n return async (tx: StacksTransaction) => {\n const { mnemonic, passphrase } = await getMnemonicFn();\n const keychain = await deriveRootKeychainFromMnemonic(mnemonic, passphrase);\n const privateKey = deriveStxPrivateKey({\n keychain,\n index: extractStacksDerivationPathAccountIndex(keyOrigin),\n });\n return signStacksTransaction(tx, privateKey);\n };\n}\n\ninterface InitalizeStacksSignerArgs {\n descriptor: string;\n network: NetworkModes;\n signFn: StacksSignerFn;\n}\nexport function initalizeStacksSigner(args: InitalizeStacksSignerArgs): StacksSigner {\n const { descriptor, network, signFn } = args;\n\n const publicKey = createStacksPublicKey(extractKeyFromDescriptor(descriptor));\n\n return {\n ...decomposeDescriptor(descriptor),\n // here we overwrite the accountIndex with the derivation path account index for stx\n accountIndex: extractStacksDerivationPathAccountIndex(descriptor),\n publicKey: publicKey.data,\n network,\n address: publicKeyToAddress(\n whenNetwork(network)({\n mainnet: AddressVersion.MainnetSingleSig,\n testnet: AddressVersion.TestnetSingleSig,\n }),\n publicKey\n ),\n sign: signFn,\n };\n}\n","import { bytesToHex } from '@noble/hashes/utils';\nimport { HDKey } from '@scure/bip32';\nimport { compressPrivateKey } from '@stacks/encryption';\nimport { ChainID, createStacksPrivateKey, getPublicKey } from '@stacks/transactions';\n\nimport {\n DerivationPathDepth,\n createDescriptor,\n createKeyOriginPath,\n extractAddressIndexFromPath,\n} from '@leather.io/crypto';\nimport type { NetworkModes } from '@leather.io/models';\nimport { assertIsTruthy, isString, toHexString } from '@leather.io/utils';\n\nexport const stxDerivationWithAccount = `m/44'/5757'/0'/0/{account}`;\n\nexport function makeAccountIndexDerivationPathFactory(derivationPath: string) {\n return (account: number) => derivationPath.replace('{account}', account.toString());\n}\n\nexport function extractStacksDerivationPathAccountIndex(path: string) {\n if (!path.includes('5757')) throw new Error('Not a valid Stacks derivation path: ' + path);\n return extractAddressIndexFromPath(path);\n}\n\n/**\n * Stacks accounts always use the same derivation path, regardless of network\n */\nexport const makeStxDerivationPath =\n makeAccountIndexDerivationPathFactory(stxDerivationWithAccount);\n\nexport function stacksChainIdToCoreNetworkMode(chainId: ChainID): NetworkModes {\n return whenStacksChainId(chainId)({ [ChainID.Mainnet]: 'mainnet', [ChainID.Testnet]: 'testnet' });\n}\n\ninterface WhenStacksChainIdMap<T> {\n [ChainID.Mainnet]: T;\n [ChainID.Testnet]: T;\n}\nexport function whenStacksChainId(chainId: ChainID) {\n return <T>(chainIdMap: WhenStacksChainIdMap<T>): T => chainIdMap[chainId];\n}\n\n// From `@stacks/wallet-sdk` package we are trying not to use\nexport function deriveStxPrivateKey({ keychain, index }: { keychain: HDKey; index: number }) {\n if (keychain.depth !== DerivationPathDepth.Root) throw new Error('Root keychain must be depth 0');\n const accountKeychain = keychain.derive(makeStxDerivationPath(index));\n assertIsTruthy(accountKeychain.privateKey);\n return bytesToHex(compressPrivateKey(accountKeychain.privateKey));\n}\n\nexport function deriveStxPublicKey({ keychain, index }: { keychain: HDKey; index: number }) {\n return getPublicKey(createStacksPrivateKey(deriveStxPrivateKey({ keychain, index })));\n}\n\nexport function stacksRootKeychainToAccountDescriptor(keychain: HDKey, accountIndex: number) {\n const fingerprint = toHexString(keychain.fingerprint);\n const publicKey = deriveStxPublicKey({ keychain, index: accountIndex });\n return createDescriptor(\n createKeyOriginPath(fingerprint, makeStxDerivationPath(accountIndex)),\n bytesToHex(publicKey.data)\n );\n}\n\nexport function getStacksBurnAddress(chainId: ChainID): string {\n switch (chainId) {\n case ChainID.Mainnet:\n return 'SP00000000000003SCNSJTCSE62ZF4MSE';\n case ChainID.Testnet:\n default:\n return 'ST000000000000000000002AMW42H';\n }\n}\n\nexport function cleanHex(hexWithMaybePrefix: string): string {\n if (!isString(hexWithMaybePrefix)) return hexWithMaybePrefix;\n return hexWithMaybePrefix.startsWith('0x')\n ? hexWithMaybePrefix.replace('0x', '')\n : hexWithMaybePrefix;\n}\n\n/**\n * Gets the contract name of a fully qualified name of an asset.\n *\n * @param contractId - the source string: [principal].[contract-name] or [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractName(contractId: string): string {\n if (contractId.includes('.')) {\n const parts = contractId?.split('.');\n if (contractId.includes('::')) {\n return parts[1].split('::')[0];\n }\n return parts[1];\n }\n return contractId;\n}\n\n/**\n * Gets the asset name from a a fully qualified name of an asset.\n *\n * @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractAssetName(contractId: string): string {\n if (!contractId.includes('::')) return contractId;\n return contractId.split('::')[1];\n}\n\n/**\n * Gets the parts that make up a fully qualified name of an asset.\n *\n * @param contractId - the fully qualified name of the asset: [principal].[contract-name]::[asset-name]\n */\nexport function getStacksContractIdStringParts(contractId: string): {\n contractAddress: string;\n contractAssetName: string;\n contractName: string;\n} {\n if (!contractId.includes('.') || !contractId.includes('::')) {\n return {\n contractAddress: contractId,\n contractAssetName: contractId,\n contractName: contractId,\n };\n }\n\n const contractAddress = contractId.split('.')[0];\n const contractAssetName = getStacksContractAssetName(contractId);\n const contractName = getStacksContractName(contractId);\n\n return {\n contractAddress,\n contractAssetName,\n contractName,\n };\n}\n","import { hexToBytes } from '@noble/hashes/utils';\nimport {\n deserializeCV,\n makeUnsignedContractCall,\n makeUnsignedContractDeploy,\n makeUnsignedSTXTokenTransfer,\n} from '@stacks/transactions';\nimport BigNumber from 'bignumber.js';\n\nimport { cleanHex } from '../stacks.utils';\nimport { getPostConditions } from './post-condition.utils';\nimport {\n StacksUnsignedContractCallOptions,\n StacksUnsignedContractDeployOptions,\n StacksUnsignedTokenTransferOptions,\n StacksUnsignedTransactionOptions,\n TransactionTypes,\n isTransactionTypeSupported,\n} from './transaction.types';\n\nexport function initNonce(nonce: number | string) {\n return new BigNumber(nonce, 10);\n}\n\nexport function generateUnsignedContractCall(options: StacksUnsignedContractCallOptions) {\n const { fee, functionArgs, nonce, postConditions } = options;\n\n const fnArgs = functionArgs.map(arg => deserializeCV(hexToBytes(cleanHex(arg))));\n\n const parsedOptions = {\n fee: fee.amount.toString(),\n functionArgs: fnArgs,\n nonce: initNonce(nonce).toString(),\n postConditions: getPostConditions(postConditions),\n };\n\n return makeUnsignedContractCall({ ...options, ...parsedOptions });\n}\n\nexport function generateUnsignedContractDeploy(options: StacksUnsignedContractDeployOptions) {\n const { fee, nonce, postConditions } = options;\n\n const parsedOptions = {\n fee: fee.amount.toString(),\n nonce: initNonce(nonce).toString(),\n postConditions: getPostConditions(postConditions),\n };\n\n return makeUnsignedContractDeploy({ ...options, ...parsedOptions });\n}\n\nexport function generateUnsignedStxTokenTransfer(options: StacksUnsignedTokenTransferOptions) {\n const { amount, fee, nonce } = options;\n\n const parsedOptions = {\n amount: amount.amount.toString(),\n fee: fee.amount.toString(),\n nonce: initNonce(nonce).toString(),\n };\n\n return makeUnsignedSTXTokenTransfer({ ...options, ...parsedOptions });\n}\n\nexport async function generateStacksUnsignedTransaction(options: StacksUnsignedTransactionOptions) {\n const isValid = isTransactionTypeSupported(options.txType);\n\n if (!isValid) throw new Error(`Invalid Transaction Type: ${options.txType}`);\n\n switch (options.txType) {\n case TransactionTypes.StxTokenTransfer:\n return generateUnsignedStxTokenTransfer(options);\n case TransactionTypes.ContractCall:\n return generateUnsignedContractCall(options);\n case TransactionTypes.ContractDeploy:\n return generateUnsignedContractDeploy(options);\n }\n}\n","import { hexToBytes } from '@noble/hashes/utils';\nimport { BytesReader, PostCondition, deserializePostCondition } from '@stacks/transactions';\n\nimport { isString } from '@leather.io/utils';\n\nexport function getPostConditionFromString(postCondition: string): PostCondition {\n try {\n const reader = new BytesReader(hexToBytes(postCondition));\n return deserializePostCondition(reader);\n } catch (err) {\n throw new Error('Not a serialized post condition');\n }\n}\n\nexport function getPostCondition(postCondition: string | PostCondition): PostCondition {\n return isString(postCondition) ? getPostConditionFromString(postCondition) : postCondition;\n}\n\nexport function getPostConditions(\n postConditions?: (string | PostCondition)[]\n): PostCondition[] | undefined {\n return postConditions?.map(getPostCondition);\n}\n","import {\n UnsignedContractCallOptions,\n UnsignedContractDeployOptions,\n UnsignedTokenTransferOptions,\n} from '@stacks/transactions';\n\nimport { Money, ReplaceTypes } from '@leather.io/models';\n\nexport enum TransactionTypes {\n ContractCall = 'contract_call',\n ContractDeploy = 'smart_contract',\n StxTokenTransfer = 'token_transfer',\n}\n\nexport function isTransactionTypeSupported(txType: TransactionTypes) {\n return (\n txType === TransactionTypes.ContractCall ||\n txType === TransactionTypes.ContractDeploy ||\n txType === TransactionTypes.StxTokenTransfer\n );\n}\n\nexport type StacksUnsignedContractCallOptions = ReplaceTypes<\n UnsignedContractCallOptions,\n {\n fee: Money;\n functionArgs: string[];\n nonce: number | string;\n }\n> & { txType: TransactionTypes.ContractCall };\n\nexport type StacksUnsignedContractDeployOptions = ReplaceTypes<\n UnsignedContractDeployOptions,\n {\n fee: Money;\n nonce: number | string;\n }\n> & { txType: TransactionTypes.ContractDeploy };\n\nexport type StacksUnsignedTokenTransferOptions = ReplaceTypes<\n UnsignedTokenTransferOptions,\n {\n amount: Money;\n fee: Money;\n nonce: number | string;\n }\n> & { txType: TransactionTypes.StxTokenTransfer };\n\nexport type StacksUnsignedTransactionOptions =\n | StacksUnsignedContractCallOptions\n | StacksUnsignedContractDeployOptions\n | StacksUnsignedTokenTransferOptions;\n","import { bytesToHex } from '@noble/hashes/utils';\nimport { hashMessage } from '@stacks/encryption';\nimport {\n ClarityValue,\n StacksPrivateKey,\n getPublicKey,\n publicKeyToString,\n signMessageHashRsv,\n signStructuredData,\n} from '@stacks/transactions';\n\ninterface SignatureData {\n signature: string;\n publicKey: string;\n}\n\nexport function signMessage(message: string, privateKey: StacksPrivateKey): SignatureData {\n const hash = hashMessage(message);\n return {\n signature: signMessageHashRsv({ privateKey, messageHash: bytesToHex(hash) }).data,\n publicKey: publicKeyToString(getPublicKey(privateKey)),\n };\n}\n\nexport function signStructuredDataMessage(\n message: ClarityValue,\n domain: ClarityValue,\n privateKey: StacksPrivateKey\n): SignatureData {\n const signature = signStructuredData({\n message,\n domain,\n privateKey,\n }).data;\n\n return {\n signature,\n publicKey: publicKeyToString(getPublicKey(privateKey)),\n };\n}\n"],"mappings":"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","names":["createStacksPrivateKey","createStacksPrivateKey","hexToBytes","isString","TransactionTypes","hexToBytes","bytesToHex","getPublicKey"]}
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "@leather.io/stacks",
|
|
3
3
|
"author": "leather.io",
|
|
4
4
|
"description": "Stacks package for Leather",
|
|
5
|
-
"version": "1.
|
|
5
|
+
"version": "1.5.0",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"type": "module",
|
|
8
8
|
"exports": {
|
|
@@ -16,10 +16,10 @@
|
|
|
16
16
|
"@stacks/stacks-blockchain-api-types": "7.8.2",
|
|
17
17
|
"@stacks/transactions": "6.17.0",
|
|
18
18
|
"bignumber.js": "9.1.2",
|
|
19
|
-
"@leather.io/
|
|
20
|
-
"@leather.io/
|
|
21
|
-
"@leather.io/models": "0.
|
|
22
|
-
"@leather.io/utils": "0.20.
|
|
19
|
+
"@leather.io/constants": "0.13.6",
|
|
20
|
+
"@leather.io/crypto": "1.6.15",
|
|
21
|
+
"@leather.io/models": "0.23.0",
|
|
22
|
+
"@leather.io/utils": "0.20.1"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|
|
25
25
|
"tsup": "8.1.0",
|