@huma-finance/sdk 0.0.11 → 0.0.12

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.
Files changed (67) hide show
  1. package/API.md +432 -0
  2. package/README.md +9 -5
  3. package/dist/cjs/graphql/generatedTypes.d.ts +40 -0
  4. package/dist/cjs/graphql/generatedTypes.js +9 -0
  5. package/dist/cjs/graphql/generatedTypes.js.map +1 -0
  6. package/dist/cjs/graphql/index.d.ts +1 -0
  7. package/dist/cjs/graphql/index.js +5 -0
  8. package/dist/cjs/graphql/index.js.map +1 -0
  9. package/dist/cjs/helpers/PoolContractHelper.d.ts +4 -1
  10. package/dist/cjs/helpers/PoolContractHelper.js +19 -1
  11. package/dist/cjs/helpers/PoolContractHelper.js.map +1 -1
  12. package/dist/cjs/services/ARWeaveService.d.ts +1 -18
  13. package/dist/cjs/services/ARWeaveService.js +2 -36
  14. package/dist/cjs/services/ARWeaveService.js.map +1 -1
  15. package/dist/cjs/services/ReceivableService.d.ts +11 -0
  16. package/dist/cjs/services/ReceivableService.js +71 -20
  17. package/dist/cjs/services/ReceivableService.js.map +1 -1
  18. package/dist/graphql/generatedTypes.d.ts +40 -0
  19. package/dist/graphql/generatedTypes.js +5 -0
  20. package/dist/graphql/generatedTypes.js.map +1 -0
  21. package/dist/graphql/index.d.ts +1 -0
  22. package/dist/graphql/index.js +2 -0
  23. package/dist/graphql/index.js.map +1 -0
  24. package/dist/helpers/ERC20TransferableReceivableContractHelper.d.ts +10 -10
  25. package/dist/helpers/ERC20TransferableReceivableContractHelper.js +17 -17
  26. package/dist/helpers/PoolContractHelper.d.ts +15 -12
  27. package/dist/helpers/PoolContractHelper.js +32 -16
  28. package/dist/helpers/PoolContractHelper.js.map +1 -1
  29. package/dist/helpers/RealWorldReceivableContractHelper.d.ts +10 -10
  30. package/dist/helpers/RealWorldReceivableContractHelper.js +17 -17
  31. package/dist/helpers/index.d.ts +3 -3
  32. package/dist/helpers/index.js +3 -3
  33. package/dist/hooks/index.d.ts +4 -4
  34. package/dist/hooks/index.js +4 -4
  35. package/dist/hooks/useContract.d.ts +13 -13
  36. package/dist/hooks/useContract.js +26 -26
  37. package/dist/hooks/useERC20TransferableReceivableContract.d.ts +12 -12
  38. package/dist/hooks/useERC20TransferableReceivableContract.js +16 -16
  39. package/dist/hooks/usePoolContract.d.ts +60 -60
  40. package/dist/hooks/usePoolContract.js +48 -48
  41. package/dist/hooks/useRealWorldReceivableContract.d.ts +10 -10
  42. package/dist/hooks/useRealWorldReceivableContract.js +15 -15
  43. package/dist/index.d.ts +4 -4
  44. package/dist/index.js +4 -4
  45. package/dist/services/ARWeaveService.d.ts +81 -84
  46. package/dist/services/ARWeaveService.js +120 -131
  47. package/dist/services/ARWeaveService.js.map +1 -1
  48. package/dist/services/EAService.d.ts +18 -18
  49. package/dist/services/EAService.js +9 -9
  50. package/dist/services/ReceivableService.d.ts +87 -76
  51. package/dist/services/ReceivableService.js +184 -134
  52. package/dist/services/ReceivableService.js.map +1 -1
  53. package/dist/services/SubgraphService.d.ts +53 -53
  54. package/dist/services/SubgraphService.js +79 -79
  55. package/dist/services/index.d.ts +4 -4
  56. package/dist/services/index.js +4 -4
  57. package/dist/tsconfig.cjs.tsbuildinfo +1 -1
  58. package/dist/utils/chain.d.ts +14 -14
  59. package/dist/utils/chain.js +28 -28
  60. package/dist/utils/index.d.ts +3 -3
  61. package/dist/utils/index.js +3 -3
  62. package/dist/utils/poolInfo.d.ts +9 -9
  63. package/dist/utils/poolInfo.js +9 -9
  64. package/dist/utils/web3.d.ts +4 -4
  65. package/dist/utils/web3.js +23 -23
  66. package/getting-started.md +191 -0
  67. package/package.json +11 -5
@@ -1,119 +1,110 @@
1
- import Bundlr from '@bundlr-network/client';
2
- import request, { gql } from 'graphql-request';
3
- /**
4
- * Get the configuration for Bundlr network given a chain ID
5
- *
6
- * @function
7
- * @memberof ArweaveService
8
- * @param {number} chainId - The chain ID.
9
- * @returns {BundlrConfig} - The configuration for the Bundlr network.
10
- */
11
- export function getBundlrNetworkConfig(chainId) {
12
- switch (chainId) {
13
- case 5:
14
- return {
15
- nodeUrl: 'https://devnet.bundlr.network',
16
- currency: 'ethereum',
17
- providerUrl: 'https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161',
18
- };
19
- case 80001:
20
- return {
21
- nodeUrl: 'https://devnet.bundlr.network',
22
- currency: 'matic',
23
- providerUrl: 'https://rpc-mumbai.matic.today',
24
- };
25
- default:
26
- return {
27
- nodeUrl: '',
28
- currency: '',
29
- };
30
- }
31
- }
32
- /**
33
- * Prefund the Bundlr network with the specified amount. Required if not lazy funding.
34
- *
35
- * @async
36
- * @function
37
- * @memberof ArweaveService
38
- * @param {BundlrConfig} config - The configuration for the Bundlr network.
39
- * @param {any} signer - The wallet to send funds from. This can be either a web3 signer or a private key string.
40
- * @param {number} amount - The amount to fund, denoted in whatever currency specified by the config.
41
- * @returns {Promise<FundResponse>} - The fund response.
42
- */
43
- async function prefundBundlr(config,
44
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
45
- signer, amount) {
46
- const bundlr = new Bundlr(config.nodeUrl, config.currency, signer, config.providerUrl
47
- ? {
48
- providerUrl: config.providerUrl,
49
- }
50
- : undefined);
51
- await bundlr.ready();
52
- return bundlr.fund(amount);
53
- }
54
- /**
55
- * Store data on ARWeave using the Bundlr Network.
56
- *
57
- * @async
58
- * @function
59
- * @memberof ArweaveService
60
- * @param {BundlrConfig} config - Configuration object for the Bundlr instance.
61
- * @param {Web3Provider | string} signerOrPrivateKey - Wallet object used for interacting with the Bundlr instance.
62
- * If calling from a browser, this should be a `Web3Provider` instance. If calling from a Node.js
63
- * environment, this should be a private key string.
64
- * @param {JSON} data - The data to store in the Bundlr instance.
65
- * @param {Array<{ name: string, value: string }>} tags - Array of tag objects with `name` and `value` properties.
66
- * @param {boolean} [lazyFund=true] - Optional flag to fund the Bundlr instance lazily. If set to `false`, the
67
- * Bundlr node should already be funded or else uploads will fail.
68
- * @returns {Promise<UploadResponse>} Promise resolving with the upload response.
69
- */
70
- async function storeData(config, signerOrPrivateKey, data, tags, lazyFund = true) {
71
- const bundlr = new Bundlr(config.nodeUrl, config.currency, signerOrPrivateKey, config.providerUrl
72
- ? {
73
- providerUrl: config.providerUrl,
74
- }
75
- : undefined);
76
- await bundlr.ready();
77
- const dataStr = JSON.stringify(data);
78
- if (lazyFund) {
79
- const size = Buffer.byteLength(dataStr);
80
- const price = await bundlr.getPrice(size);
81
- // Add a buffer of 10% to account for fluctuations in the price
82
- price.multipliedBy(1.1);
83
- console.log(`Funding bundlr with ${price} ${config.currency} to upload data`);
84
- await bundlr.fund(price);
85
- }
86
- return bundlr.upload(dataStr, { tags });
87
- }
88
- /**
89
- * Helper method to query the Arweave network for receivables metadata previously uploaded.
90
- *
91
- * @async
92
- * @function
93
- * @memberof ArweaveService
94
- * @param {number} chainId - The chain ID.
95
- * @param {POOL_NAME} poolName - The pool name tag to query.
96
- * @param {POOL_TYPE} poolType - The pool type tag to query.
97
- * @param {string} sender - The sender tag to query.
98
- * @param {string} referenceId - The referenceId tag to query, whatever was used when uploading the metadata.
99
- * @returns {Promise<any>} Promise resolving with the queried data.
100
- */
101
- async function queryForMetadata(chainId, poolName, poolType, sender, referenceId) {
102
- var _a, _b, _c, _d;
103
- const config = getBundlrNetworkConfig(chainId);
1
+ import Bundlr from '@bundlr-network/client';
2
+ import request, { gql } from 'graphql-request';
3
+ /**
4
+ * Get the configuration for Bundlr network given a chain ID
5
+ *
6
+ * @function
7
+ * @memberof ArweaveService
8
+ * @param {number} chainId - The chain ID.
9
+ * @returns {BundlrConfig} - The configuration for the Bundlr network.
10
+ */
11
+ export function getBundlrNetworkConfig(chainId) {
12
+ switch (chainId) {
13
+ case 5:
14
+ return {
15
+ nodeUrl: 'https://devnet.bundlr.network',
16
+ currency: 'ethereum',
17
+ providerUrl: 'https://goerli.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161',
18
+ };
19
+ case 80001:
20
+ return {
21
+ nodeUrl: 'https://devnet.bundlr.network',
22
+ currency: 'matic',
23
+ providerUrl: 'https://rpc-mumbai.matic.today',
24
+ };
25
+ default:
26
+ return {
27
+ nodeUrl: '',
28
+ currency: '',
29
+ };
30
+ }
31
+ }
32
+ /**
33
+ * Prefund the Bundlr network with the specified amount. Required if not lazy funding.
34
+ *
35
+ * @async
36
+ * @function
37
+ * @memberof ArweaveService
38
+ * @param {BundlrConfig} config - The configuration for the Bundlr network.
39
+ * @param {any} signer - The wallet to send funds from. This can be either a web3 signer or a private key string.
40
+ * @param {number} amount - The amount to fund, denoted in whatever currency specified by the config.
41
+ * @returns {Promise<FundResponse>} - The fund response.
42
+ */
43
+ async function prefundBundlr(config,
44
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
45
+ signer, amount) {
46
+ const bundlr = new Bundlr(config.nodeUrl, config.currency, signer, config.providerUrl
47
+ ? {
48
+ providerUrl: config.providerUrl,
49
+ }
50
+ : undefined);
51
+ await bundlr.ready();
52
+ return bundlr.fund(amount);
53
+ }
54
+ /**
55
+ * Store data on ARWeave using the Bundlr Network.
56
+ *
57
+ * @async
58
+ * @function
59
+ * @memberof ArweaveService
60
+ * @param {BundlrConfig} config - Configuration object for the Bundlr instance.
61
+ * @param {Web3Provider | string} signerOrPrivateKey - Wallet object used for interacting with the Bundlr instance.
62
+ * If calling from a browser, this should be a `Web3Provider` instance. If calling from a Node.js
63
+ * environment, this should be a private key string.
64
+ * @param {JSON} data - The data to store in the Bundlr instance.
65
+ * @param {Array<{ name: string, value: string }>} tags - Array of tag objects with `name` and `value` properties.
66
+ * @param {boolean} [lazyFund=true] - Optional flag to fund the Bundlr instance lazily. If set to `false`, the
67
+ * Bundlr node should already be funded or else uploads will fail.
68
+ * @returns {Promise<UploadResponse>} Promise resolving with the upload response.
69
+ */
70
+ async function storeData(config, signerOrPrivateKey, data, tags, lazyFund = true) {
71
+ const bundlr = new Bundlr(config.nodeUrl, config.currency, signerOrPrivateKey, config.providerUrl
72
+ ? {
73
+ providerUrl: config.providerUrl,
74
+ }
75
+ : undefined);
76
+ await bundlr.ready();
77
+ const dataStr = JSON.stringify(data);
78
+ if (lazyFund) {
79
+ const size = Buffer.byteLength(dataStr);
80
+ const price = await bundlr.getPrice(size);
81
+ // Add a buffer of 10% to account for fluctuations in the price
82
+ price.multipliedBy(1.1);
83
+ console.log(`Funding bundlr with ${price} ${config.currency} to upload data`);
84
+ await bundlr.fund(price);
85
+ }
86
+ return bundlr.upload(dataStr, { tags });
87
+ }
88
+ /**
89
+ * Helper method to query the Arweave network for receivables metadata previously uploaded.
90
+ *
91
+ * @async
92
+ * @function
93
+ * @memberof ArweaveService
94
+ * @param {number} chainId - The chain ID.
95
+ * @param {string} sender - The sender tag to query.
96
+ * @param {string} referenceId - The referenceId tag to query, whatever was used when uploading the metadata.
97
+ * @returns {Promise<any>} Promise resolving with the queried data.
98
+ */
99
+ async function queryForMetadata(chainId, sender, referenceId) {
100
+ var _a, _b, _c, _d;
101
+ const config = getBundlrNetworkConfig(chainId);
104
102
  const query = gql `
105
- query ArweaveHumaMetadataQuery(
106
- $poolName: String!
107
- $poolType: String!
108
- $sender: String!
109
- $referenceId: String!
110
- ) {
103
+ query ArweaveHumaMetadataQuery($sender: String!, $referenceId: String!) {
111
104
  transactions(
112
105
  owners: [$sender]
113
106
  tags: [
114
107
  { name: "appName", values: ["HumaFinance"] }
115
- { name: "poolName", values: [$poolName] }
116
- { name: "poolType", values: [$poolType] }
117
108
  { name: "referenceId", values: [$referenceId] }
118
109
  ]
119
110
  ) {
@@ -124,24 +115,22 @@ async function queryForMetadata(chainId, poolName, poolType, sender, referenceId
124
115
  }
125
116
  }
126
117
  }
127
- `;
128
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
129
- const data = await request(`${config.nodeUrl}/graphql`, query, {
130
- poolName,
131
- poolType,
132
- sender,
133
- referenceId,
134
- });
135
- return (_d = (_c = (_b = (_a = data === null || data === void 0 ? void 0 : data.transactions) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.node) === null || _d === void 0 ? void 0 : _d.id;
136
- }
137
- /**
138
- * An object that contains functions to interact with Huma-related data stored on ARWeave
139
- * @namespace ARWeaveService
140
- */
141
- export const ARWeaveService = {
142
- queryForMetadata,
143
- storeData,
144
- prefundBundlr,
145
- getBundlrNetworkConfig,
146
- };
118
+ `;
119
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
120
+ const data = await request(`${config.nodeUrl}/graphql`, query, {
121
+ sender,
122
+ referenceId,
123
+ });
124
+ return (_d = (_c = (_b = (_a = data === null || data === void 0 ? void 0 : data.transactions) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.node) === null || _d === void 0 ? void 0 : _d.id;
125
+ }
126
+ /**
127
+ * An object that contains functions to interact with Huma-related data stored on ARWeave
128
+ * @namespace ARWeaveService
129
+ */
130
+ export const ARWeaveService = {
131
+ queryForMetadata,
132
+ storeData,
133
+ prefundBundlr,
134
+ getBundlrNetworkConfig,
135
+ };
147
136
  //# sourceMappingURL=ARWeaveService.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"ARWeaveService.js","sourceRoot":"","sources":["../../src/services/ARWeaveService.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ARWeaveService.js","sourceRoot":"","sources":["../../src/services/ARWeaveService.ts"],"names":[],"mappings":"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"}
@@ -1,18 +1,18 @@
1
- /**
2
- * Object representing the response to the underwriting approval request.
3
- * @typedef {Object} ApprovalResult
4
- */
5
- /**
6
- * Object representing an invoice payload for underwriting approval.
7
- *
8
- * @typedef {Object} EAPayload
9
- */
10
- export type { ApprovalResult, EAPayload } from '@huma-finance/shared';
11
- /**
12
- * An object that contains functions to interact with Huma's EAVerse service.
13
- *
14
- * @namespace EAService
15
- */
16
- export declare const EAService: {
17
- approve: (payload: import("@huma-finance/shared").EAPayload, chainId: number, isDev?: boolean | undefined) => Promise<import("@huma-finance/shared").Approval>;
18
- };
1
+ /**
2
+ * Object representing the response to the underwriting approval request.
3
+ * @typedef {Object} ApprovalResult
4
+ */
5
+ /**
6
+ * Object representing an invoice payload for underwriting approval.
7
+ *
8
+ * @typedef {Object} EAPayload
9
+ */
10
+ export type { ApprovalResult, EAPayload } from '@huma-finance/shared';
11
+ /**
12
+ * An object that contains functions to interact with Huma's EAVerse service.
13
+ *
14
+ * @namespace EAService
15
+ */
16
+ export declare const EAService: {
17
+ approve: (payload: import("@huma-finance/shared").EAPayload, chainId: number, isDev?: boolean | undefined) => Promise<import("@huma-finance/shared").Approval>;
18
+ };
@@ -1,10 +1,10 @@
1
- import { EAService as EAServiceInternal } from '@huma-finance/shared';
2
- /**
3
- * An object that contains functions to interact with Huma's EAVerse service.
4
- *
5
- * @namespace EAService
6
- */
7
- export const EAService = {
8
- approve: EAServiceInternal.approve,
9
- };
1
+ import { EAService as EAServiceInternal } from '@huma-finance/shared';
2
+ /**
3
+ * An object that contains functions to interact with Huma's EAVerse service.
4
+ *
5
+ * @namespace EAService
6
+ */
7
+ export const EAService = {
8
+ approve: EAServiceInternal.approve,
9
+ };
10
10
  //# sourceMappingURL=EAService.js.map
@@ -1,76 +1,87 @@
1
- import { TransactionResponse, Web3Provider } from '@ethersproject/providers';
2
- import { BigNumberish, ethers, Overrides } from 'ethers';
3
- import { POOL_NAME, POOL_TYPE } from '@huma-finance/shared';
4
- declare function declareReceivablePaymentByReferenceId(signer: ethers.Signer, referenceId: string, paymentAmount: number): Promise<TransactionResponse>;
5
- /**
6
- * Declares a payment on a RealWorldReceivable given a tokenID of the receivable.
7
- *
8
- * @async
9
- * @function
10
- * @memberof ReceivableService
11
- * @param {ethers.Signer} signer - The signer used to send the transaction. Note only the receivable owner can pay the receivable.
12
- * @param {BigNumberish} receivableTokenId - The ID of the receivable token to pay.
13
- * @param {number} paymentAmount - The amount to pay the receivable.
14
- * @returns {Promise<TransactionResponse>} - A Promise of the transaction receipt.
15
- * @throws {Error} - Throws an error if the RealWorldReceivable contract is not available on the network.
16
- */
17
- declare function declareReceivablePaymentByTokenId(signer: ethers.Signer, receivableTokenId: BigNumberish, paymentAmount: number): Promise<TransactionResponse>;
18
- /**
19
- * Creates a new RealWorldReceivable token on the given chain of the signer
20
- *
21
- * @async
22
- * @function
23
- * @memberof ReceivableService
24
- * @param {ethers.Signer} signer - The signer used to send the transaction.
25
- * @param {POOL_NAME} poolName - The name of the credit pool to mint the receivable token from. Used to lookup the pool address.
26
- * @param {POOL_TYPE} poolType - The type of the credit pool to mint the receivable token from. Used to lookup the pool address.
27
- * @param {number} currencyCode - The ISO 4217 currency code that the receivable is denominated in
28
- * @param {number} receivableAmount - The amount of the receivable token to mint.
29
- * @param {number} maturityDate - The maturity date of the receivable token, in UNIX timestamp format.
30
- * @param {string} uri - The URI of the receivable token metadata.
31
- * @param {Overrides} gasOpts - The gas options to use for the transaction.
32
- * @returns {Promise<TransactionResponse>} - A Promise of the transaction response.
33
- * @throws {Error} - Throws an error if the RealWorldReceivable contract is not available on the network.
34
- */
35
- declare function createReceivable(signer: ethers.Signer, poolName: POOL_NAME, poolType: POOL_TYPE, currencyCode: number, receivableAmount: number, maturityDate: number, uri: string, gasOpts?: Overrides): Promise<TransactionResponse>;
36
- /**
37
- * Creates a RealWorldReceivable token with metadata uploaded onto ARWeave
38
- *
39
- * @async
40
- * @function
41
- * @memberof ReceivableService
42
- * @param {Web3Provider | ethers.Signer} signerOrProvider - If calling this function from a browser, this function expects a Web3Provider.
43
- * If calling this function from a server, this function expects an ethers Signer. Note that privateKey only needs to be included
44
- * from server calls.
45
- * @param {string | null} privateKey - Private key of the wallet used to upload metadata to ARWeave. Only required if calling this function from a server.
46
- * @param {number} chainId - The chain ID to mint the receivable token on and pay ARWeave funds from.
47
- * @param {string} recipient - The receivable token recipient.
48
- * @param {POOL_NAME} poolName - The pool name. Used to lookup the pool address to pay to.
49
- * @param {POOL_TYPE} poolType - The pool type. Used to lookup the pool address to pay to.
50
- * @param {number} currencyCode - The ISO 4217 currency code that the receivable is denominated in
51
- * @param {number} receivableAmount - The receivable amount.
52
- * @param {number} maturityDate - The maturity date of the receivable, in UNIX timestamp format.
53
- * @param {JSON} metadata - The metadata in JSON format. This will be uploaded onto ARWeave
54
- * @param {number} referenceId - An internal identifier value added as a tag on ARWeave, for easily querying the metadata later.
55
- * @param {Array<{ name: string, value: string }>} extraTags - Any extraTags you'd like to tag your metadata with. Note that metadata on
56
- * ARWeave is indexed by these tags, so make sure to include any tags that you'd like to be able to query by.
57
- * @param {boolean} [lazyFund=true] - Whether to lazy fund the ARWeave uploads. If true, the ARWeave uploads will be paid for by the
58
- * metadata uploader immediately before uploading. If false, the ARWeave node must be pre-funded before calling this function.
59
- * @param {Overrides} [gasOpts] - Optional gas overrides for the transaction.
60
- * @returns {Promise<TransactionResponse>} - The transaction receipt.
61
- */
62
- declare function createReceivableWithMetadata(signerOrProvider: Web3Provider | ethers.Signer, privateKey: string | null, chainId: number, poolName: POOL_NAME, poolType: POOL_TYPE, currencyCode: number, receivableAmount: number, maturityDate: number, metadata: JSON, referenceId: string, extraTags: {
63
- name: string;
64
- value: string;
65
- }[], lazyFund?: boolean, gasOpts?: Overrides): Promise<TransactionResponse>;
66
- /**
67
- * An object that contains functions to interact with Huma's receivables.
68
- * @namespace ReceivableService
69
- */
70
- export declare const ReceivableService: {
71
- createReceivableWithMetadata: typeof createReceivableWithMetadata;
72
- createReceivable: typeof createReceivable;
73
- declareReceivablePaymentByTokenId: typeof declareReceivablePaymentByTokenId;
74
- declareReceivablePaymentByReferenceId: typeof declareReceivablePaymentByReferenceId;
75
- };
76
- export {};
1
+ import { TransactionResponse, Web3Provider } from '@ethersproject/providers';
2
+ import { BigNumberish, ethers, Overrides } from 'ethers';
3
+ import { POOL_NAME, POOL_TYPE } from '@huma-finance/shared';
4
+ /**
5
+ * Declares a payment on a RealWorldReceivable given a reference ID of the receivable, which was used as an index for ARWeave data.
6
+ *
7
+ * @async
8
+ * @function
9
+ * @memberof ReceivableService
10
+ * @param {ethers.Signer} signer - The signer used to send the transaction. Note only the receivable owner can pay the receivable.
11
+ * @param {string} referenceId - An internal identifier value added as a tag on ARWeave
12
+ * @param {number} paymentAmount - The amount to declare paid to the receivable.
13
+ * @returns {Promise<TransactionResponse>} - A Promise of the transaction receipt.
14
+ */
15
+ declare function declareReceivablePaymentByReferenceId(signer: ethers.Signer, referenceId: string, paymentAmount: number): Promise<TransactionResponse>;
16
+ /**
17
+ * Declares a payment on a RealWorldReceivable given a tokenID of the receivable.
18
+ *
19
+ * @async
20
+ * @function
21
+ * @memberof ReceivableService
22
+ * @param {ethers.Signer} signer - The signer used to send the transaction. Note only the receivable owner can pay the receivable.
23
+ * @param {BigNumberish} receivableTokenId - The ID of the receivable token to pay.
24
+ * @param {number} paymentAmount - The amount to pay the receivable.
25
+ * @returns {Promise<TransactionResponse>} - A Promise of the transaction receipt.
26
+ * @throws {Error} - Throws an error if the RealWorldReceivable contract is not available on the network.
27
+ */
28
+ declare function declareReceivablePaymentByTokenId(signer: ethers.Signer, receivableTokenId: BigNumberish, paymentAmount: number): Promise<TransactionResponse>;
29
+ /**
30
+ * Creates a new RealWorldReceivable token on the given chain of the signer
31
+ *
32
+ * @async
33
+ * @function
34
+ * @memberof ReceivableService
35
+ * @param {ethers.Signer} signer - The signer used to send the transaction.
36
+ * @param {POOL_NAME} poolName - The name of the credit pool to mint the receivable token from. Used to lookup the pool address.
37
+ * @param {POOL_TYPE} poolType - The type of the credit pool to mint the receivable token from. Used to lookup the pool address.
38
+ * @param {number} currencyCode - The ISO 4217 currency code that the receivable is denominated in
39
+ * @param {number} receivableAmount - The amount of the receivable token to mint.
40
+ * @param {number} maturityDate - The maturity date of the receivable token, in UNIX timestamp format.
41
+ * @param {string} uri - The URI of the receivable token metadata.
42
+ * @param {Overrides} gasOpts - The gas options to use for the transaction.
43
+ * @returns {Promise<TransactionResponse>} - A Promise of the transaction response.
44
+ * @throws {Error} - Throws an error if the RealWorldReceivable contract is not available on the network.
45
+ */
46
+ declare function createReceivable(signer: ethers.Signer, poolName: POOL_NAME, poolType: POOL_TYPE, currencyCode: number, receivableAmount: number, maturityDate: number, uri: string, gasOpts?: Overrides): Promise<TransactionResponse>;
47
+ /**
48
+ * Creates a RealWorldReceivable token with metadata uploaded onto ARWeave
49
+ *
50
+ * @async
51
+ * @function
52
+ * @memberof ReceivableService
53
+ * @param {Web3Provider | ethers.Signer} signerOrProvider - If calling this function from a browser, this function expects a Web3Provider.
54
+ * If calling this function from a server, this function expects an ethers Signer. Note that privateKey only needs to be included
55
+ * from server calls.
56
+ * @param {string | null} privateKey - Private key of the wallet used to upload metadata to ARWeave. Only required if calling this function from a server.
57
+ * @param {number} chainId - The chain ID to mint the receivable token on and pay ARWeave funds from.
58
+ * @param {string} recipient - The receivable token recipient.
59
+ * @param {POOL_NAME} poolName - The pool name. Used to lookup the pool address to pay to.
60
+ * @param {POOL_TYPE} poolType - The pool type. Used to lookup the pool address to pay to.
61
+ * @param {number} currencyCode - The ISO 4217 currency code that the receivable is denominated in
62
+ * @param {number} receivableAmount - The receivable amount.
63
+ * @param {number} maturityDate - The maturity date of the receivable, in UNIX timestamp format.
64
+ * @param {JSON} metadata - The metadata in JSON format. This will be uploaded onto ARWeave
65
+ * @param {number} referenceId - An internal identifier value added as a tag on ARWeave, for easily querying the metadata later.
66
+ * @param {Array<{ name: string, value: string }>} extraTags - Any extraTags you'd like to tag your metadata with. Note that metadata on
67
+ * ARWeave is indexed by these tags, so make sure to include any tags that you'd like to be able to query by.
68
+ * @param {boolean} [lazyFund=true] - Whether to lazy fund the ARWeave uploads. If true, the ARWeave uploads will be paid for by the
69
+ * metadata uploader immediately before uploading. If false, the ARWeave node must be pre-funded before calling this function.
70
+ * @param {Overrides} [gasOpts] - Optional gas overrides for the transaction.
71
+ * @returns {Promise<TransactionResponse>} - The transaction receipt.
72
+ */
73
+ declare function createReceivableWithMetadata(signerOrProvider: Web3Provider | ethers.Signer, privateKey: string | null, chainId: number, poolName: POOL_NAME, poolType: POOL_TYPE, currencyCode: number, receivableAmount: number, maturityDate: number, metadata: JSON, referenceId: string, extraTags: {
74
+ name: string;
75
+ value: string;
76
+ }[], lazyFund?: boolean, gasOpts?: Overrides): Promise<TransactionResponse>;
77
+ /**
78
+ * An object that contains functions to interact with Huma's receivables.
79
+ * @namespace ReceivableService
80
+ */
81
+ export declare const ReceivableService: {
82
+ createReceivableWithMetadata: typeof createReceivableWithMetadata;
83
+ createReceivable: typeof createReceivable;
84
+ declareReceivablePaymentByTokenId: typeof declareReceivablePaymentByTokenId;
85
+ declareReceivablePaymentByReferenceId: typeof declareReceivablePaymentByReferenceId;
86
+ };
87
+ export {};