From c0963a79c49572abcb432f8b76a1a8c1ce567259 Mon Sep 17 00:00:00 2001 From: Ryan Sauge Date: Thu, 11 Apr 2024 15:22:12 +0200 Subject: [PATCH] Add solidity API --- README.md | 13 +- doc/accessControl/access-control.drawio | 1 - doc/schema/IncomeVault | 2 +- doc/schema/drawio/Debt-Global.drawio.png | Bin 43472 -> 0 bytes .../drawio/Debt-Segragated Deposit.drawio.png | Bin 41166 -> 0 bytes .../IncomeVault-Segragated Deposit.drawio.png | Bin 0 -> 44016 bytes doc/solidityAPI/index.md | 337 ++++++++++++++++++ doc/specification.md | 2 +- 8 files changed, 346 insertions(+), 9 deletions(-) delete mode 100644 doc/accessControl/access-control.drawio delete mode 100644 doc/schema/drawio/Debt-Global.drawio.png delete mode 100644 doc/schema/drawio/Debt-Segragated Deposit.drawio.png create mode 100644 doc/schema/drawio/IncomeVault-Segragated Deposit.drawio.png create mode 100644 doc/solidityAPI/index.md diff --git a/README.md b/README.md index 007fd7c..ebc19d0 100644 --- a/README.md +++ b/README.md @@ -30,12 +30,13 @@ A report performed with [Slither](https://github.com/crytic/slither) is availabl Here a summary of the main documentation -| Document | Link/Files | -| ----------------------- | ---------------------------------------- | -| Specification | [doc/specification](./doc/specification) | -| Technical documentation | [doc/technical](./doc/technical) | -| Toolchain | [doc/TOOLCHAIN.md](./doc/TOOLCHAIN.md) | -| Surya report | [doc/surya](./doc/surya/) | +| Document | Link/Files | +| ----------------------- | ------------------------------------------------------ | +| Specification | [doc/specification](./doc/specification) | +| Technical documentation | [doc/technical](./doc/technical) | +| Solidity API (docgen) | [doc/solidityAPI/index.md](./doc/solidityAPI/index.md) | +| Toolchain | [doc/TOOLCHAIN.md](./doc/TOOLCHAIN.md) | +| Surya report | [doc/surya](./doc/surya/) | ## Foundry diff --git a/doc/accessControl/access-control.drawio b/doc/accessControl/access-control.drawio deleted file mode 100644 index e200a74..0000000 --- a/doc/accessControl/access-control.drawio +++ /dev/null @@ -1 +0,0 @@ -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 \ No newline at end of file diff --git a/doc/schema/IncomeVault b/doc/schema/IncomeVault index b686bc2..33dca70 100644 --- a/doc/schema/IncomeVault +++ b/doc/schema/IncomeVault @@ -1 +1 @@ -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 \ No newline at end of file +3Vpdk6I4FP01Vu0+aAEhAo9+TU9v9Yxu6/bOPHWlJWq2gFgQW51fP0ECksSvVnSd6Zcml5CQc0/OvTdYA51w9RCj+ewL9XFQswx/VQPdmmU5juvxf6llnVksq+lmlmlM/Mxmbg1D8gMLoyGsC+LjROrIKA0YmcvGMY0iPGaSDcUxXcrdJjSQZ52jKdYMwzEKdOu/xGczsQwAmtsbnzGZzvKpm9DO7oQo7y2WksyQT5clE+jVQCemlGVX4aqDgxS+HJjsuU977hZvFuOInfKAb//3TCLYf+l/6c/8dzgY/j2oW9ko7yhYiBV38ZwmhIl3ZuscCRz5rRRQ3hoHKEnIuAbaMxYG3GDyy5guIh+ncxm8xd8pXn/jjbrRMAyQW76ntxuGa+eG7qr8QHctWglDMcuni2iE8x4DHJMQMxyLjhMaMcEaE/K2DorAKaGLeIwPIGEKqvKZp5gdggxkHbEvUUeA/oApf794zTuIXcARgJYnWLHckggKXsxK9MltMQ4QI+8yCZHg8rSYoph1QAlfbzGlJ4Ypdp0hj5CBIR4qU0YZxwbKQIYyUAbWgYHyjnQySbDUh1+U0NqaNqz9AIOBxuA/GKdIzeqkupORuRVycrI/dU5zFz6hNy5aEpVRQKZRynNOopRp7XccM8JFoSVuhMT30zHaMU7ID/S2GS+l4zxd9mbJsF2D3ZMIenBf8onxapfSiUklLdnFPqNhNS0oeRFUwjEoP3A9Bzuag0cb/yq+lPVnOSMMD+dos+WXPDjJHj5ZNjQH7AXas5W9krdLW960duz5prEfegnLjwLnasBl++DuoDMLDO4GO0/D7tKAuCLsm7iTXn8v2bdBMG2kGFhOA4q2GvGKyGrIQRUeCakn++1oAHROjH+3iXWupXCnmWJ3Vrhz1bip0mtPuKtK6fKk98qsK6il8+4mBDuaijknEtG9KyKahqpi3plpl2mae/TwVkTMJbxMxLaUTOnEvNtcqthWFSRTAF7GleunS6Ze0l0qIlIt5ymqAM0junBZ3VZdOXYbFXCUXPtcDVBLLwCVoHZtCbA1GnHCDhlii6QTIBKWqqxkY/2Vyqtik1wsCXxPAKW+ql9YYN1AI/SaqiqNSCXCkiXCBcdSh3uRiELmDc915AisFyS3O7+xnXNFxPL4Ukp/6rANQ3m3ParCmYDWpW5iI+5dgOXsXsGWx9mIt2e+XhSPUzXrknfic8pvVO2XUrJ8K1ehZKYJgOQ3sxI614ErP3JF/+qFe7fXHr12e4P+8HH0+tx/6mneTWZonl4uwqA1ZrTsyI3TB2naS2jq0DfKGA13eJpR5ZyELlhAItwpPkx8SNNOPzxRiw5TVypwy5MTSy9iP9PA59vjt4IdKgIH/2/Y9XPwx2jMB39Bi+D+jvxs9ahlF213AQjMqyFYfVIkTl82dVN+6JLlRJ5z+Axmx8Ffdecrd1YyFV+VBBcgPDPdUTgFzeskN6b6vmKeD77Wzlyoqjho6XkOi1GUTHbo8P0mN1ZlyQ3PbeymktJfRt5Kc5klZl/t8AE++Z8mUfL1L+I99uv6IdwmlXlp/fM0eu0Pes+tUf/5N8xolA9pwLhaaOXN7e8vMrdtf8cCej8B5ZrxU9sgFMf/mv6ol4SQtj9qdW537uZdd5vulx0mmHLS0BFqW//6QUOaAol2nY1Rf1F4UCLf94H38moPjKbLC45mk68swbQXeMmyB856QQCCfiB/KcuqsPgg8gtLykmibZVhTB6xNnraOicJzo2JgjEqyMw0xizLcCwMG+KcLcxpd4yaT52hFDuGcYyoa/1JEjEprAEAUTXwGZN0Uj46gmExMkXlbL2VfIISttgygfMeGHHGRNGaLkeYKvlKYYrPfWoY3fxlHGdilw8wgc5n5OjP9e/x6pxePk7IETjSqzwgOtc7/pLFbIp/oDkVcuAWUZTFWO9ArEpd5GZmqhmvKMkSzEEPnC4mRODxDMVqYCGBkLaJmFLZ82Xzls3lzOTydmNA8X3KlfXbXMhlsLbnBQU+lO07lglNhR/KvrvpcgeYC7zcMmkRLrDcjeArOUWPhp52iGYSAFj0F5WDh3rKZNu1QBuRZirdLF2pLhta+H9wQuA4wdEbZ8mJwllJTlGek9gUlxfiyp5XoxpeEnGtZ6r2jZ6n2mfL7c6qFF71rjAncoeYlzMyudvr7c56oWNYdqu11r2V7jU6LWdzHuPn8RSIp1g8MQ8U83BinGYXgS0XwxoXlzaOKRLkwbwD6tyun3DFSCYqwiKLMGkwlyj2rT+1fWTthaC1kG8tVAjjLLSmcLPt/cEEDpjfJRDSct0LIjRVBzy7zWcbF28BawL5zNVwgFMehZZ00D3lflDDgO2rFzvloSPmyVSKJAo5OybfMLDkC135AlAj3+BQ8sEmFm86J57NHuh7r8xe1CTer86LFw5eW7z+q4TnY9gYoL03F59hp+IztOJzaGd2u8ZnaMVnYN9+B47Pg9cg02/k8ugNZo5Rt8j0LTL7+5IZWQsF7ZI5bE52uhev7WQHRG7IaTfZKTGo0697IdvWL6zJd1rWz61r9AL3JUXuT5jq5IKzezxilKmrK2OqKHF6Ryi1TIiSNFN3qlRN3XKnSi0SI3qiB6YkSdRjat3ReOkG/ZfxiO950EQ6cPP3qMYjB6tx+HVFjo/skTB0D0m7HnHf7tc/PbMCeNpQAXy3nhoMzNssAq6jgN+qp9zSgeOOvfO8tWz7vIE0Sv1sbqbBezY309vuSG7WH1pZAtwzNxvY5QGv3dzMd0spHcCp/VcEuCOGw05juIkj/43hsGUM3aLUh8Qw2hHDMuR0hMMBMPGBe3NoxduwbQ4PWd8zOKzYe7qOYnJYoXdjkPfiFRNvVxC79W2bb4Nov1XuCqJvgQjthO7QILrlvDFOOUqRkGgFXoJnLCfCgfPdZuJ9qxrm12XidXWFPb4KkN3qXzEKj1b/0gLO/wI=5Vtdc6M2FP01ntl2JjuAEODH2El2t9Pt7EzSafuoGNlmFiNXyIm9v76SEV9XJMY22Ow0DzEIIcPVueeeeyWP0HS1/cTJevmVhTQeOVa4HaG7keNgFyP5oVp2WYvjeEHWsuBRmLXZZcNj9IPqRku3bqKQprWOgrFYROt644wlCZ2JWhvhnL3Wu81ZXP/WNVlQo+FxRmKz9a8oFEv9Ggh55YXPNFos86/2sJtdWZG8t36VdElC9lppQvcjNOWMiexotZ3SWJkvN0x238MbV4sn4zQRbW6YYfvrb7fbz/PNl7s/BY7n3/9lN3qUFxJv9Bt/SZU5YxKt5Cdb04SGe8NxZfplpK6KaEXlxwg96DcTu9xefMlWzxtp9MnrMhL0cU1m6sqrhIdsW4pVLM9seThnidDTbbvy3Hyb/NEoF3RbadJv94myFRV8J7voqw72P+LsJg037Gvbv1bmztJ9ltVpc3VHovGyKEYvLSoPtFGPMLBjGNiwGU3CWwVVeSbtnqbRrG4qzjZJSNWXSJNP6DYSf6tj+a7Z2T+6nzq+21a63e30SWtjp2zDZ/QwXgThCyre6aedgIY19zKnrjIx2DLnJW/jNCYieqk7ZdNc6W/4xiL5ZgUysFXHBRqD6c7eW99V9SEwEPKs2kA+AgNlhjEG2kOneO3T0YQMNE2/Pt0+GZA64HwkXWdkOY+2Clh9eGMATBUEpi/aHmrwxbyxc190m8kujF5kkEkUzZGYUxKqt5gqBtxT3/BoDmDQbSA5p8GZbKcvksN9kZxdobiS8JpJTlqU7zJmtCyUN2R3IsvPG8qb92e1u79RLiddUN45b45b8iYaFG+6Xp03xxBBbXkT2/WBAr8db0rIkF2l21p1SN9+YM+v+8YY1TSRPMhG7JSUHZNX0oSs0yUTX5I5mxAxW37INNNUYUW6AuW/mB4i5/x38iwVdJ2r42iRKK+RmFPAnCimiKRCvdUXVlEYqjEmnKbRD/K8H0+hVxtLDo4nI3zXCs/vujekqEJ26y8dVYVtE3VZH20f27UZss8Dat6Fzecp7SXken1xmzW6vHwbFr1gVPdW24IyvDW/WMZIQET0LMx8AyWCfafJExMkftys1/Gu6vzSqUkiJ+rnoYDcCzqgAIwtp0sKyGPVuDboDRigP4IITPbfT/JdISu9WJp28iwzaG+hjva9IBSsXytStIYbSz2yqntAQEFRWqOZKwhTEORt5JjK1EUNfALTsc6E6fgweadLslaHqaDKROuKBFRNFUl40KQqmcpt2o+JUQCSqnFDUtWk/YO+LJwX6jqMj4WOr2t4fEjBX7UwojXgQYE/HlQEhrnkGOry1oUREICNTKEjgQ8LMBcR+LZZJb0gjXBJ+SJiKs7f2MFRqD2CWHwooKyrM4vzRmAtQ6YMqGSlzJeFVSd/5oFUahDUt7ZnGrV46MuUamyzhHguXzfyrvUu71ZqNbjG8gc4vsNCdttKdg7DgTC267yFqWMp24Uub9vtOLszWjXrJr1A8TgJcCo0z4Ci0xKKwbCQOAb4KTTA0Uh04Uj4wkg0C9gpmdMnTpJ0TvkDZ6sPWezJsvg8TTOLeFfPweCkFCtU1ZATNIUcOHvdhZwWWZgcJlqntG6fUlMRLh6lCqJ7eRTHUxYzvr9RYk79qc6CywS5cmU+11f6iOwuWGhuUEtNiS5cLuxumblNGiZ541GfMi6WbMESEt+XrVXbwxLTMxOCrfasVzCy2h2QtWjzBu/Ow1tp3tUkQNtFGbsl755JqDC3wbAa2jMLOmaas98HUhayAKCkswjgsbXJT1gCPVY3ta9oNlFoHUh7QOiHgqyKO2JVILrctqTan783RCxQdfzpsiP3+tmRY9bxTRo9SpIa8vIEiXp5SRq0ZMYchgORpMYykAuFZOsFJQxHgvKobzI2lxV2NP1fgjEH2eHNE/6g0OhCDHkwHJy8vIlh1a3vfWfHVflLYfgQxTkUS5koE95jQNo14A7j6ISST1GGORc0MCoGp4LGdcByXHBp0DgtQPNe3qcQM6Ssz4ULnONrp32o82ruWyHipJ149tACxAmO3WOA8Dzo67AC29bXfRuM5MOqcFcb7CA9Yfirg0M3+MfeMLZc4Cc9LPEhsxb9BzNdabD7cwoiOHuDzo310R7nJel8v/x5cO9/Dw4y87ZZtoG7yIfxRFdwpZnVpm71X3DZ29iec7+K1FPTF6p9ZUgFXuTCH7mUsrImRxp+5QI5obswZCYrPYWhYzKV0wNKDqfDlcGB5b9wIcWHlZLWGQdcR/Ba7tg+7NHytPzRW9a9/PEguv8P3Vpbc9o6EP41zOQ8wPh+eQSStmemnWSSTNuclzPCFuCJbTGynMD59UfCkrEkOzgUaMlTpJW8tna//XZXZGBPs/VnDFbLbyiG6cAy4vXAvh5Ylhs6If3DJJtKYjm+W0kWOIkrmbkTPCT/QS40uLRMYlhIGwlCKUlWsjBCeQ4jIskAxuhV3jZHqfzWFVhATfAQgVSX/khisuTHsG1vt/AFJouleLXnOtVKBsRufpRiCWL02hDZNwN7ihEi1ShbT2HKzCcMUz33qWO1/jIMc9LngdXTvReRez/7B97Oh+nzvz+eJ0Ou5QWkJT/x9Nvj+JF/MdkIO9CPX7FhtEmTPIbYHtiT12VC4MMKRGzhlQKAypYkS+nMpMMZKunO+OusFoDoeYGZ9LYkVA3k8qLyuunS8RzlhKPA9OhcP6T4YogJXDdE/NCfIcogwRu6RayaAkwbIeDz14ZHQy5bNpxpCyHgKFrUynd2pgNu6neY3dLM/nceUd3fQZmSj2R811Bsb+i2t9ts7xinsr2t2V4zOMzjMSMPZvMUFEUSydbFlXXpzGgxG1wn5CffycZPfB8bX6+bE2YU0/BHLhfcQZzQQ0IsNuX0wD+bk6fmZKdsO6u0uWKuKuv0ZoFKHMH9aCUALyDZTyYwljhVx0bD926L64UMwxSQ5EVm4jY48DfcoYSerIaeH8jQq/UKFdW5+VNN4lQUmaanaLIDWVNlGU3TFp71uQ9HrKMh1hoxv+VgVSwRmYAU5BHdf0WowwfWlK1BRhR/6cimvvkKZjRNS4AGabLIGdopNhhgJizCE5oGx3whS+KY6ZhgSBkDzLb6GKpW7NBbM7iTgXvdi0XeDEuVWurczl8qZc82yjFGZuD4ssOOAijlATSfF/Ak/nbPxVBGL4aygr38ZPblJyu0RidgKFEa7mMo689iKKUw0XJeX4ZSqc52FEUnJihPA6w92pqHlDing1nFUBfERiIEj8BGRhi6knf8y2KjQHPuI3qGzK1L2k1R/3SVq2WWjiOCmg7cOvsOFQlJEHPkDBGCshYPE6QUtKiqWqd1n9fGa50E0r9gtdSCNWgpWFsowTtVuRpq5jdZbFHWT7Lr5IW2x3m8Tfwtyf7XksQBxaffTe51zqmr3SdppucdoyPrHJ4mgotME7a5p/zsmybqtCAUWedNE+IcDSzflym8yResH/1AXW9gyYb23Lau19URc7obB1O/6XEYj6AVxIDA2/wRg7yYQ3wl3UTseolqHHPGOR3Z7BhkH90Y+6nGdzyJbMIwOCPd9O6bjZ58U9cUlmFLABuKFuE8jOT6Cr7VerMvI3mOXBp5ahrtYCSKNLBpbON1X+cHB0qB7AbSXSkdVBqVp09fXJn6TaDLwvKK4JK38nOQFqdL7lLnZr4RbUOzR2oPXCm5d8aaM7K7esrDw02E0YWl98A4UjAFpieDvGd6f28wmYZSR7juG9F0tEjRb8Fu7qdDdsY6K32kGsJSKKumxt9YQ+h9/rFpqbVJMN+ds49aTpyhAHD+KEZybCW+1azcl5EcNe2aZ244fA2wHsuuhNe6nzDK+tW744zillzSfXodrEe4wrJsI5QcKW7rDwXarxRWdLr70bzavvvnA/vmfw==dZHBDoIwDIafZndchXBH1IsnDp4XVtmSQcmYAX16IRviop7Wff/fdW0ZFO10sqJXF5JoGE/kxODAON9ByudjIQ9P0jz3oLFaBtMGKv3EAJNA71riEBkdkXG6j2FNXYe1i5iwlsbYdiMTV+1Fg1+gqoX5plctnfKUA2SbcEbdqLV0lu690orVHVoZlJA0fiAoGRSWyPmonQo0y/TWwfi84x/1/TOLnfuRMAfb2/MlWhGULw== \ No newline at end of file diff --git a/doc/schema/drawio/Debt-Global.drawio.png b/doc/schema/drawio/Debt-Global.drawio.png deleted file mode 100644 index f7c469e38f5d29d3bb01cc08818e2ef70ed25387..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 43472 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 diff --git a/doc/schema/drawio/Debt-Segragated Deposit.drawio.png b/doc/schema/drawio/Debt-Segragated Deposit.drawio.png deleted file mode 100644 index 5ea8b797ba69b368688bd240dc0e9e326b460b50..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 41166 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%0DKG@K23#W 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 mapping(uint256 => bool)) claimedDividend +``` + +### segragatedDividend + +```solidity +mapping(uint256 => uint256) segragatedDividend +``` + +### segragatedClaim + +```solidity +mapping(uint256 => bool) segragatedClaim +``` + +### _computeDividendBatch + +```solidity +function _computeDividendBatch(uint256 time, address[] tokenHolders, uint256[] tokenHoldersBalance, uint256 tokenTotalSupply) internal view returns (uint256[] tokenHolderDividend) +``` + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | dividend time | +| tokenHolders | address[] | addresses to compute dividend | +| tokenHoldersBalance | uint256[] | the sender balance | +| tokenTotalSupply | uint256 | the total supply | + +### _computeDividend + +```solidity +function _computeDividend(uint256 time, uint256 senderBalance, uint256 tokenTotalSupply) internal view returns (uint256 tokenHolderDividend) +``` + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | dividend time | +| senderBalance | uint256 | token holder balance | +| tokenTotalSupply | uint256 | the total supply | + +### _transferDividend + +```solidity +function _transferDividend(uint256 time, address tokenHolder, uint256 tokenHolderDividend) internal +``` + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | dividend time | +| tokenHolder | address | addresses to send the dividends | +| tokenHolderDividend | uint256 | the computed dividends | + +## IncomeVaultInvariantStorage + +### INCOME_VAULT_OPERATOR_ROLE + +```solidity +bytes32 INCOME_VAULT_OPERATOR_ROLE +``` + +### INCOME_VAULT_DEPOSIT_ROLE + +```solidity +bytes32 INCOME_VAULT_DEPOSIT_ROLE +``` + +### INCOME_VAULT_DISTRIBUTE_ROLE + +```solidity +bytes32 INCOME_VAULT_DISTRIBUTE_ROLE +``` + +### INCOME_VAULT_WITHDRAW_ROLE + +```solidity +bytes32 INCOME_VAULT_WITHDRAW_ROLE +``` + +### IncomeVault_claimNotActivated + +```solidity +error IncomeVault_claimNotActivated() +``` + +### IncomeVault_dividendAlreadyClaimed + +```solidity +error IncomeVault_dividendAlreadyClaimed() +``` + +### IncomeVault_noDividendToClaim + +```solidity +error IncomeVault_noDividendToClaim() +``` + +### IncomeVault_AdminWithAddressZeroNotAllowed + +```solidity +error IncomeVault_AdminWithAddressZeroNotAllowed() +``` + +### IncomeVault_TokenPaymentWithAddressZeroNotAllowed + +```solidity +error IncomeVault_TokenPaymentWithAddressZeroNotAllowed() +``` + +### IncomeVault_CMTATWithAddressZeroNotAllowed + +```solidity +error IncomeVault_CMTATWithAddressZeroNotAllowed() +``` + +### IncomeVault_FailApproval + +```solidity +error IncomeVault_FailApproval() +``` + +### IncomeVault_noAmountSend + +```solidity +error IncomeVault_noAmountSend() +``` + +### IncomeVault_notEnoughAmount + +```solidity +error IncomeVault_notEnoughAmount() +``` + +### newDeposit + +```solidity +event newDeposit(uint256 time, address sender, uint256 dividend) +``` + +### DividendClaimed + +```solidity +event DividendClaimed(uint256 time, address sender, uint256 dividend) +``` + +## IncomeVaultOpen + +### claimDividend + +```solidity +function claimDividend(uint256 time) public +``` + +claim your payment + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | provide the date where you want to receive your payment | + +### claimDividendBatch + +```solidity +function claimDividendBatch(uint256[] times) public +``` + +claim your payment + +_Don't check if the dividends have been already claimed before external call to CMTAT._ + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| times | uint256[] | provide the dates where you want to receive your payment | + +## IncomeVaultRestricted + +### deposit + +```solidity +function deposit(uint256 time, uint256 amount) public +``` + +deposit an amount to pay the dividends. + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | provide the date where you want to perform a deposit | +| amount | uint256 | the amount to deposit | + +### withdraw + +```solidity +function withdraw(uint256 time, uint256 amount, address withdrawAddress) public +``` + +withdraw a certain amount at a specified time. + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | provide the date where you want to perform a deposit | +| amount | uint256 | the amount to withdraw | +| withdrawAddress | address | address to receive `amount`of tokens | + +### withdrawAll + +```solidity +function withdrawAll(uint256 amount, address withdrawAddress) public +``` + +withdraw all tokens from ERC20TokenPayment contracts deposited + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| amount | uint256 | the amount to withdraw | +| withdrawAddress | address | address to receive `amount`of tokens | + +### distributeDividend + +```solidity +function distributeDividend(address[] addresses, uint256 time) public +``` + +deposit an amount to pay the dividends. + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| addresses | address[] | compute and transfer dividend for these holders | +| time | uint256 | dividend time | + +### setStatusClaim + +```solidity +function setStatusClaim(uint256 time, bool status) public +``` + +set the status to open or close the claims for a given time + +#### Parameters + +| Name | Type | Description | +| ---- | ---- | ----------- | +| time | uint256 | target time | +| status | bool | boolean (true or false) | + diff --git a/doc/specification.md b/doc/specification.md index 4a85b0e..56de04d 100644 --- a/doc/specification.md +++ b/doc/specification.md @@ -16,7 +16,7 @@ Each deposit is segregated in its time value. A `time` is the dividends distribution date (Unix Timestamp) to the token holders. -![Debt-Segragated Deposit.drawio](../doc/schema/drawio/Debt-Segragated Deposit.drawio.png) +![IncomeVault-Segragated Deposit.drawio](../doc/schema/drawio/IncomeVault-Segragated Deposit.drawio.png) ### ValidationModule