tonutils 1.0.0a1__py3-none-any.whl → 1.0.0a2__py3-none-any.whl

tonutils/contracts/__init__.py

@@ -1,7 +1,19 @@
 from .codes import CONTRACT_CODES
+from .jetton import (
+    JettonMasterGetMethods,
+    JettonWalletGetMethods,
+    JettonMasterStandard,
+    JettonMasterStablecoin,
+    JettonMasterStablecoinV2,
+    JettonWalletStandard,
+    JettonWalletStablecoin,
+    JettonWalletStablecoinV2,
+)
 from .nft import (
     BaseNFTCollection,
     BaseNFTItem,
+    NFTCollectionGetMethods,
+    NFTItemGetMethods,
     NFTCollectionEditable,
     NFTCollectionStandard,
     NFTItemEditable,
@@ -32,6 +44,16 @@ __all__ = [
     "BaseNFTCollection",
     "BaseNFTItem",
     "BaseWallet",
+    "JettonMasterGetMethods",
+    "JettonWalletGetMethods",
+    "JettonMasterStandard",
+    "JettonMasterStablecoin",
+    "JettonMasterStablecoinV2",
+    "JettonWalletStandard",
+    "JettonWalletStablecoin",
+    "JettonWalletStablecoinV2",
+    "NFTCollectionGetMethods",
+    "NFTItemGetMethods",
     "NFTCollectionEditable",
     "NFTCollectionStandard",
     "NFTItemEditable",

tonutils/contracts/base.py

@@ -6,18 +6,21 @@ from pyapiq.exceptions import APIQException
 from pytoniq_core import Address, Cell, StateInit
 
 from .codes import CONTRACT_CODES
-from ..exceptions import NotRefreshedError
+from ..exceptions import (
+    ContractError,
+    NotRefreshedError,
+)
 from ..protocols import (
     ClientProtocol,
     ContractProtocol,
 )
 from ..types import (
-    ContractStateInfo,
-    WorkchainID,
     AddressLike,
-    ContractState,
-    BaseContractVersion,
     BaseContractData,
+    BaseContractVersion,
+    ContractStateInfo,
+    ContractState,
+    WorkchainID,
 )
 from ..utils import to_cell
 
@@ -29,7 +32,17 @@ TContract = t.TypeVar("TContract", bound="BaseContract")
 class BaseContract(ContractProtocol[D]):
     _data_model: t.Type[D]
 
-    VERSION: t.ClassVar[BaseContractVersion]
+    VERSION: t.ClassVar[t.Union[BaseContractVersion, str]]
+
+    @classmethod
+    def get_default_code(cls) -> Cell:
+        try:
+            default_code = to_cell(CONTRACT_CODES[cls.VERSION])
+        except KeyError:
+            raise ContractError(
+                cls, f"No contract code defined for VERSION {cls.VERSION!r}."
+            )
+        return default_code
 
     def __init__(
         self,
@@ -135,7 +148,7 @@ class BaseContract(ContractProtocol[D]):
         data: Cell,
         workchain: WorkchainID = WorkchainID.BASECHAIN,
     ) -> TContract:
-        code = to_cell(CONTRACT_CODES[cls.VERSION])
+        code = cls.get_default_code()
         return cls.from_code_and_data(client, code, data, workchain)
 
     @classmethod

tonutils/contracts/codes.py

@@ -3,11 +3,13 @@ import typing as t
 from ..types import (
     WalletVersion,
     BaseContractVersion,
+    JettonWalletVersion,
+    JettonMasterVersion,
     NFTCollectionVersion,
     NFTItemVersion,
 )
 
-CONTRACT_CODES: t.Dict[BaseContractVersion, str] = {
+CONTRACT_CODES: t.Dict[t.Union[BaseContractVersion, str], str] = {
     WalletVersion.WalletV1R1: "b5ee9c72010101010044000084ff0020dda4f260810200d71820d70b1fed44d0d31fd3ffd15112baf2a122f901541044f910f2a2f80001d31f3120d74a96d307d402fb00ded1a4c8cb1fcbffc9ed54",
     WalletVersion.WalletV1R2: "b5ee9c720101010100530000a2ff0020dd2082014c97ba9730ed44d0d70b1fe0a4f260810200d71820d70b1fed44d0d31fd3ffd15112baf2a122f901541044f910f2a2f80001d31f3120d74a96d307d402fb00ded1a4c8cb1fcbffc9ed54",
     WalletVersion.WalletV1R3: "b5ee9c7201010101005f0000baff0020dd2082014c97ba218201339cbab19c71b0ed44d0d31fd70bffe304e0a4f260810200d71820d70b1fed44d0d31fd3ffd15112baf2a122f901541044f910f2a2f80001d31f3120d74a96d307d402fb00ded1a4c8cb1fcbffc9ed54",
@@ -27,4 +29,10 @@ CONTRACT_CODES: t.Dict[BaseContractVersion, str] = {
     NFTItemVersion.NFTItemStandard: "b5ee9c7201020d010001d0000114ff00f4a413f4bcf2c80b01020162020c0202ce0309020120040802d70c8871c02497c0f83434c0c05c6c2497c0f83e903e900c7e800c5c75c87e800c7e800c3c00812ce3850c1b088d148cb1c17cb865407e90350c0408fc00f801b4c7f4cfe08417f30f45148c2ea3a1cc840dd78c9004f80c0d0d0d4d60840bf2c9a884aeb8c097c12103fcbc20050701f65135c705f2e191fa4021f001fa40d20031fa00820afaf0801ba121945315a0a1de22d70b01c300209206a19136e220c2fff2e192218e3e821005138d91c85009cf16500bcf16712449145446a0708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb00104794102a375be2060082028e3526f0018210d53276db103744006d71708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb0093303234e25502f00300727082108b77173505c8cbff5004cf1610248040708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb0000113e910c1c2ebcb853600201200a0b003b3b513434cffe900835d27080269fc07e90350c04090408f80c1c165b5b60001d00f232cfd633c58073c5b3327b55200009a11f9fe005",
     NFTItemVersion.NFTItemEditable: "b5ee9c72010212010002e5000114ff00f4a413f4bcf2c80b01020162020f0202ce030c020120040b04f70c8871c02497c0f83434c0c05c6c2497c0f83e903e900c7e800c5c75c87e800c7e800c3c00816ce38596db088d148cb1c17cb865407e90353e900c040d3c00f801f4c7f4cfe08417f30f45148c2ea3a28c8412040dc409841140b820840bf2c9a8948c2eb8c0a0840701104a948c2ea3a28c8412040dc409841140a00507080a01f65136c705f2e191fa4021f001fa40d20031fa00820afaf0801ca121945315a0a1de22d70b01c300209206a19136e220c2fff2e192218e3e821005138d91c8500acf16500ccf1671244a145446b0708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb00105894102b385be2060082028e3527f0018210d53276db103845006d71708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb0093303335e25503f0030080135f03333334347082108b77173504c8cbff58cf164430128040708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb0001f65134c705f2e191fa4021f001fa40d20031fa00820afaf0801ca121945315a0a1de22d70b01c300209206a19136e220c2fff2e192218e3e8210511a4463c85008cf16500ccf1671244814544690708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb00103894102b365be2090082028e3527f0018210d53276db103848006d71708010c8cb055007cf165005fa0215cb6a12cb1fcb3f226eb39458cf17019132e201c901fb0093303630e25503f0030046e03136373782101a0b9d5116ba9e5131c705f2e19a01d4304400f003e05f06840ff2f000113e910c1c2ebcb853600201200d0e00413b513434cffe900835d27080271fc07e90353e900c040d440d380c1c165b5b5b600025013232cfd400f3c58073c5b30073c5b27b55200201201011000dbf03a78013628c000bbc7e7f801184",
     NFTItemVersion.NFTItemSoulbound: "b5ee9c720102130100033b000114ff00f4a413f4bcf2c80b01020162020e0202ce030b04bd46c2220c700915be001d0d303fa4030f002f842b38e1c31f84301c705f2e195fa4001f864d401f866fa4030f86570f867f003e002d31f0271b0e30201d33f8210d0c3bfea5230bae302821004ded1485230bae3023082102fcb26a25220ba80405060700943031d31f82100524c7ae12ba8e39d33f308010f844708210c18e86d255036d804003c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb009130e200c26c12fa40d4d30030f847f841c8cbff5006cf16f844cf1612cc14cb3f5230cb0003c30096f8465003cc02de801078b17082100dd607e3403514804003c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb0000c632f8445003c705f2e191fa40d4d30030f847f841c8cbfff844cf1613cc12cb3f5210cb0001c30094f84601ccde801078b17082100524c7ae405503804003c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb0003fa8e4031f841c8cbfff843cf1680107082108b7717354015504403804003c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb00e082101f04537a5220bae30282106f89f5e35220ba8e165bf84501c705f2e191f847c000f2e193f823f867f003e08210d136d3b35220bae302303108090a009231f84422c705f2e1918010708210d53276db102455026d830603c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb008b02f8648b02f865f003008e31f84422c705f2e191820afaf08070fb028010708210d53276db102455026d830603c8cb1f12cb3f216eb39301cf179131e2c97105c8cb055004cf1658fa0213cb6accc901fb00002082105fcc3d14ba93f2c19dde840ff2f00201200c0d00613b513434cfc07e187e90007e18dc3e188835d2708023859ffe18be90007e1935007e19be90007e1974cfcc3e19e44c38a000373e11fe11be107232cffe10f3c5be1133c5b33e1173c5b2cff27b55200201200f120201581011000db5631e005f08b0000db7b07e005f08f0001dbc7e7f8017c217c20fc21fc227c234",
+    JettonMasterVersion.JettonMasterStandard: "b5ee9c7201020d0100029c000114ff00f4a413f4bcf2c80b01020162020a0202cc030902f1d906380492f81f000e8698180b8d8492f81f07d207d2018fd0018b8eb90fd0018fd001801698fe99ff6a2687d007d206a6a18400aa9385d47199a9a9b1b289a6382f97024817d207d006a18106840306b90fd001812881a282178050a502819e428027d012c678b666664f6aa7041083deecbef29385d71814040601c036373701fa00fa40f82854120670542013541403c85004fa0258cf1601cf16ccc922c8cb0112f400f400cb00c9f9007074c8cb02ca07cbffc9d05006c705f2e04aa1034545c85004fa0258cf16ccccc9ed5401fa403020d70b01c300915be30d05003e8210d53276db708010c8cb055003cf1622fa0212cb6acb1fcb3fc98042fb0001a682102c76b9735270bae30235373723c0038e1a335035c705f2e04903fa403059c85004fa0258cf16ccccc9ed54e03502c0048e185124c705f2e049d4304300c85004fa0258cf16ccccc9ed54e05f05840ff2f00701fe365f03820898968015a015bcf2e04b02fa40d3003095c821cf16c9916de28210d1735400708018c8cb055005cf1624fa0214cb6a13cb1f14cb3f23fa443070ba8e33f828440370542013541403c85004fa0258cf1601cf16ccc922c8cb0112f400f400cb00c9f9007074c8cb02ca07cbffc9d0cf16966c227001cb01e2f40008000ac98040fb000093b5f0508806e0a84026a8280790a009f404b19e2c039e2d99924591960225e801e80196019241f200e0e9919605940f97ff93a0ef003191960ab19e2ca009f4042796d625999992e3f60102037a600b0c007dadbcf6a2687d007d206a6a183618fc1400b82a1009aa0a01e428027d012c678b00e78b666491646580897a007a00658064fc80383a6465816503e5ffe4e840001faf16f6a2687d007d206a6a183faa9040",
+    JettonMasterVersion.JettonMasterStablecoin: "b5ee9c7201021601000494000114ff00f4a413f4bcf2c80b0102016202110202cb031002f5d0cb434c0c05c6c238ecc200835c874c7c0608405e351466ea44c38601035c87e800c3b51343e803e903e90353534541168504d3214017e809400f3c58073c5b333327b55383e903e900c7e800c7d007e800c7e80004c5c3e0e80b4c7c04074cfc044bb51343e803e903e9035353449a084190adf41eeb8c08e4960407019635355161c705f2e04904fa4021fa4430c000f2e14dfa00d4d120d0d31f018210178d4519baf2e0488040d721fa00fa4031fa4031fa0020d70b009ad74bc00101c001b0f2b19130e254431b05018e2191729171e2f839206e938127519120e2216e94318128c39101e25023a813a0738103a370f83ca00270f83612a00170f836a07381040982100966018070f837a0bcf2b025597f0600ea820898968070fb02f828450470546004131503c8cb0358fa0201cf1601cf16c921c8cb0113f40012f400cb00c920f9007074c8cb02ca07cbffc9d0c8801801cb0501cf1658fa02029858775003cb6bcccc9730017158cb6acce2c98011fb005005a04314c85005fa025003cf1601cf16ccccc9ed5403f682107bdd97deba8ee53505fa00fa40f82854120770546004131503c8cb0358fa0201cf1601cf16c921c8cb0113f40012f400cb00c9f9007074c8cb02ca07cbffc9d05008c705f2e04a12a144145036c85005fa025003cf1601cf16ccccc9ed54fa40d120d70b01c000b3915be30de02582102c76b973bae302342408090b0044c8801001cb0501cf1670fa027001cb6a8210d53276db01cb1f0101cb3fc98042fb0001fe355f033401fa40d2000101d195c821cf16c9916de2c8801001cb055004cf1670fa027001cb6a8210d173540001cb1f500401cb3f23fa4430c0008e35f828440470546004131503c8cb0358fa0201cf1601cf16c921c8cb0113f40012f400cb00c9f9007074c8cb02ca07cbffc9d012cf1697316c127001cb01e2f400c980500a0004fb0004fe82106501f354ba8e2130335142c705f2e04902fa40d1400304c85005fa025003cf1601cf16ccccc9ed54e0248210fb88e119ba8e20313303d15131c705f2e0498b024034c85005fa025003cf1601cf16ccccc9ed54e02482107431f221bae30237238210cb862902bae302365b2082102508d66abae3026c318210d372158c0c0d0e0f004430335042c705f2e04901d18b028b024034c85005fa025003cf1601cf16ccccc9ed540044335142c705f2e049c85003cf16c9134440c85005fa025003cf1601cf16ccccc9ed54001e3002c705f2e049d4d4d101ed54fb04000cbadc840ff2f0001da23864658380e78b64814183fa0bc002012012130025bd9adf6a2687d007d207d206a6a6888122f82402027114150085adbcf6a2687d007d207d206a6a688a2f827c1400b82a3002098a81e46581ac7d0100e78b00e78b6490e4658089fa00097a00658064fc80383a6465816503e5ffe4e84000cfaf16f6a2687d007d207d206a6a68bf99e836c1783872ebdb514d9c97c283b7f0ae5179029e2b6119c39462719e4f46ed8f7413e62c780a417877407e978f01a40711411b1acb773a96bdd93fa83bb5ca8435013c8c4b3ac91f4589cc780a38646583fa0064a18040",
+    JettonMasterVersion.JettonMasterStablecoinV2: "b5ee9c72010215010004e0000114ff00f4a413f4bcf2c80b0102016202100202cb030f02f7d0cb434c0c05c6c3000638ecc200835c874c7c0608405e351466ea44c38601035c87e800c3b51343e803e903e90353534541168504d3214017e809400f3c58073c5b333327b55383e903e900c7e800c7d007e800c7e80004c5c3e0e80b4c7c04074cfc044bb51343e803e903e9035353449a084190adf41eeb8c08e60408019635355161c705f2e04904fa4021fa4430c000f2e14dfa00d4d120d0d31f018210178d4519baf2e0488040d721fa00fa4031fa4031fa0020d70b009ad74bc00101c001b0f2b19130e254431b05018e2191729171e2f839206e9381239b9120e2216e94318128309101e25023a813a07381032c70f83ca00270f83612a00170f836a07381040282100966018070f837a0bcf2b025597f0601ea820898968070fb0224800bd721d70b07f82846057054201314c85003fa0201cf1601cf16c9227871c8cb00cb04cb0012f400f400cb00c9513384f701f90001b07074c8cb02ca0712cb07cbf7c9d0c8801801cb0501cf1658fa020397775003cb6bcccc96317158cb6acce2c98011fb005005a04314070022c85005fa025003cf1601cf16ccccc9ed5404e62582107bdd97debae3022582102c76b973ba8ecb355f033401fa40d2000101d195c821cf16c9916de2c8801001cb055004cf1670fa027001cb6a8210d173540001cb1f500401cb3f23fa4430c00097316c127001cb01e30df400c98050fb00e0342482106501f354bae302248210fb88e119ba090b0c0d01f23505fa00fa40f82854120722800bd721d70b0755207054201314c85003fa0201cf1601cf16c9227871c8cb00cb04cb0012f400f400cb00c984f701f90001b07074c8cb02ca0712cb07cbf7c9d05008c705f2e04a12a144145036c85005fa025003cf1601cf16ccccc9ed54fa40d120d70b01c000b3915be30d0a0044c8801001cb0501cf1670fa027001cb6a8210d53276db01cb1f0101cb3fc98042fb000092f828440422800bd721d70b0755207054201314c85003fa0201cf1601cf16c9227871c8cb00cb04cb0012f400f400cb00c984f701f90001b07074c8cb02ca0712cb07cbf7c9d012cf16004230335142c705f2e04902fa40d1400304c85005fa025003cf1601cf16ccccc9ed5401fe8e20313303d15131c705f2e0498b024034c85005fa025003cf1601cf16ccccc9ed54e02482107431f221ba8e2230335042c705f2e04901d18b028b024034c85005fa025003cf1601cf16ccccc9ed54e037238210cb862902ba8e22335142c705f2e049c85003cf16c9134440c85005fa025003cf1601cf16ccccc9ed54e0360e00505b2082102508d66aba9f3002c705f2e049d4d4d101ed54fb04e06c318210d372158cbadc840ff2f0001da23864658380e78b64814183fa0bc002012011120025bd9adf6a2687d007d207d206a6a6888122f824020271131400adadbcf6a2687d007d207d206a6a688a2f827c1400914005eb90eb8583aa90382a10098a642801fd0100e78b00e78b64913c38e4658065826580097a007a00658064c27b80fc8000d8383a6465816503896583e5fbe4e84000cfaf16f6a2687d007d207d206a6a68bf99e836c1783872ebdb514d9c97c283b7f0ae5179029e2b6119c39462719e4f46ed8f7413e62c780a417877407e978f01a40711411b1acb773a96bdd93fa83bb5ca8435013c8c4b3ac91f4589cc780a38646583fa0064a18040",
+    JettonWalletVersion.JettonWalletStandard: "b5ee9c7201021101000323000114ff00f4a413f4bcf2c80b0102016202100202cc03060201d4040500c30831c02497c138007434c0c05c6c2544d7c0fc03383e903e900c7e800c5c75c87e800c7e800c1cea6d0000b4c7e08403e29fa954882ea54c4d167c0278208405e3514654882ea58c511100fc02b80d60841657c1ef2ea4d67c02f817c12103fcbc2000113e910c1c2ebcb85360020120070f020120080a01f1503d33ffa00fa4021f001ed44d0fa00fa40fa40d4305136a1522ac705f2e2c128c2fff2e2c254344270542013541403c85004fa0258cf1601cf16ccc922c8cb0112f400f400cb00c920f9007074c8cb02ca07cbffc9d004fa40f40431fa0020d749c200f2e2c4778018c8cb055008cf1670fa0217cb6b13cc809009e8210178d4519c8cb1f19cb3f5007fa0222cf165006cf1625fa025003cf16c95005cc2391729171e25008a813a08209c9c380a014bcf2e2c504c98040fb001023c85004fa0258cf1601cf16ccc9ed540201200b0e02f73b51343e803e903e90350c0234cffe80145468017e903e9014d6f1c1551cdb5c150804d50500f214013e809633c58073c5b33248b232c044bd003d0032c0327e401c1d3232c0b281f2fff274140371c1472c7cb8b0c2be80146a2860822625a019ad822860822625a028062849e5c412440e0dd7c138c34975c2c0600c0d00705279a018a182107362d09cc8cb1f5230cb3f58fa025007cf165007cf16c9718010c8cb0524cf165006fa0215cb6a14ccc971fb0010241023007cc30023c200b08e218210d53276db708010c8cb055008cf165004fa0216cb6a12cb1f12cb3fc972fb0093356c21e203c85004fa0258cf1601cf16ccc9ed5400d73b51343e803e903e90350c01f4cffe803e900c145468549271c17cb8b049f0bffcb8b08160824c4b402805af3cb8b0e0841ef765f7b232c7c572cfd400fe8088b3c58073c5b25c60063232c14933c59c3e80b2dab33260103ec01004f214013e809633c58073c5b3327b55200083d40106b90f6a2687d007d207d206a1802698fc1080bc6a28ca9105d41083deecbef09dd0958f97162e99f98fd001809d02811e428027d012c678b00e78b6664f6aa4001ba0f605da89a1f401f481f481a861",
+    JettonWalletVersion.JettonWalletStablecoin: "b5ee9c7201010101002300084202ba2918c8947e9b25af9ac1b883357754173e5812f807a3d6e642a14709595395",
+    JettonWalletVersion.JettonWalletStablecoinV2: "b5ee9c7201020d0100038a000114ff00f4a413f4bcf2c80b01020162020c02f4d001d0d3030171b0c0018e43135f038020d721ed44d0fa00fa40fa40d103d31f01840f218210178d4519ba0282107bdd97deba12b1f2f48040d721fa003012a002c85003fa0201cf1601cf16c9ed54e0fa40fa4031fa0031f401fa0031fa00013170f83a02d31f012082100f8a7ea5ba8e85303459db3ce03322030601f403d33f0101fa00fa4021fa4430c000f2e14ded44d0fa00fa40fa40d15219c705f2e0495114a120c2fff2af23800bd721d70b07f82a5425907054201314c85003fa0201cf1601cf16c9227871c8cb00cb04cb0012f400f400cb00c9514484f701f90001b07074c8cb02ca0712cb07cbf7c9d003fa40f401fa002004019620d70b009ad74bc00101c001b0f2b19130e2c88210178d451901cb1f500901cb3f5007fa0223cf1601cf1625fa025006cf16c9c8801801cb055003cf1670fa025a775003cb6bccccc944460500b02191729171e2f839206e9381239b9120e2216e94318128309101e25023a813a07381032c70f83ca00270f83612a00170f836a07381040282100966018070f837a0bcf2b0038050fb0001c85003fa0201cf1601cf16c9ed54025a8210178d4519ba8e84325adb3ce034218210595f07bcba8e843101db3ce0135f038210d372158cbadc840ff2f0070a02f4ed44d0fa00fa40fa40d106d33f0101fa00fa40fa4053a9c705b38e4ef82a5463c022800bd721d70b0755207054201314c85003fa0201cf1601cf16c9227871c8cb00cb04cb0012f400f400cb00c984f701f90001b07074c8cb02ca0712cb07cbf7c9d0500ac705f2e04a9139e25152a008fa0021925f04e30d2208090060c882107362d09c01cb1f2501cb3f5004fa0258cf1658cf16c9c8801001cb0524cf1658fa02017158cb6accc98011fb0000aed70b01c000b38e3b5043a1f82fa07381040282100966018070f837b60972fb02c8801001cb0501cf1670fa027001cb6a8210d53276db01cb1f0101cb3fc9810082fb0093145f04e258c85003fa0201cf1601cf16c9ed5401eeed44d0fa00fa40fa40d105d33f0101fa00fa40f401d15141a15237c705f2e04925c2fff2afc882107bdd97de01cb1f5801cb3f01fa0221cf1658cf16c9c8801801cb0525cf1670fa02017158cb6accc902f839206e943081160dde718102f270f8380170f836a0811bdf70f836a0bcf2b0018050fb00580b001cc85003fa0201cf1601cf16c9ed54001da0f605da89a1f401f481f481a3f055",
 }

tonutils/contracts/jetton/__init__.py

@@ -0,0 +1,25 @@
+from .get_methods import (
+    JettonMasterGetMethods,
+    JettonWalletGetMethods,
+)
+from .master import (
+    JettonMasterStandard,
+    JettonMasterStablecoin,
+    JettonMasterStablecoinV2,
+)
+from .wallet import (
+    JettonWalletStandard,
+    JettonWalletStablecoin,
+    JettonWalletStablecoinV2,
+)
+
+__all__ = [
+    "JettonMasterGetMethods",
+    "JettonWalletGetMethods",
+    "JettonMasterStandard",
+    "JettonMasterStablecoin",
+    "JettonMasterStablecoinV2",
+    "JettonWalletStandard",
+    "JettonWalletStablecoin",
+    "JettonWalletStablecoinV2",
+]

tonutils/contracts/jetton/get_methods.py

@@ -0,0 +1,74 @@
+import typing as t
+
+from pytoniq_core import Address
+
+from ...protocols import ClientProtocol
+from ...types import AddressLike
+
+
+class JettonMasterGetMethods:
+
+    @classmethod
+    async def get_jetton_data(
+        cls,
+        client: ClientProtocol,
+        address: AddressLike,
+    ) -> t.List[t.Any]:
+        method_result = await client.run_get_method(
+            address=address,
+            method_name="get_jetton_data",
+        )
+        return method_result
+
+    @classmethod
+    async def get_wallet_address(
+        cls,
+        client: ClientProtocol,
+        address: AddressLike,
+        owner_address: AddressLike,
+    ) -> Address:
+        method_result = await client.run_get_method(
+            address=address,
+            method_name="get_wallet_address",
+            stack=[owner_address],
+        )
+        return method_result[0]
+
+    @classmethod
+    async def get_next_admin_address(
+        cls,
+        client: ClientProtocol,
+        address: AddressLike,
+    ) -> t.Optional[Address]:
+        method_result = await client.run_get_method(
+            address=address,
+            method_name="get_next_admin_address",
+        )
+        return method_result[0]
+
+
+class JettonWalletGetMethods:
+
+    @classmethod
+    async def get_wallet_data(
+        cls,
+        client: ClientProtocol,
+        address: AddressLike,
+    ) -> t.List[t.Any]:
+        method_result = await client.run_get_method(
+            address=address,
+            method_name="get_wallet_data",
+        )
+        return method_result
+
+    @classmethod
+    async def get_status(
+        cls,
+        client: ClientProtocol,
+        address: AddressLike,
+    ) -> int:
+        method_result = await client.run_get_method(
+            address=address,
+            method_name="get_status",
+        )
+        return method_result[0]

tonutils/contracts/jetton/master.py

@@ -0,0 +1,259 @@
+import abc
+import typing as t
+
+from pytoniq_core import (
+    Address,
+    Cell,
+    Slice,
+    StateInit,
+    begin_cell,
+)
+
+from .get_methods import JettonMasterGetMethods
+from ..base import BaseContract
+from ...types import (
+    AddressLike,
+    ContentLike,
+    MetadataPrefix,
+    OnchainContent,
+    OffchainContent,
+    JettonMasterStandardData,
+    JettonMasterStablecoinData,
+    JettonMasterVersion,
+    WorkchainID,
+)
+from ...utils import to_cell, cell_hash
+
+D = t.TypeVar(
+    "D",
+    bound=t.Union[
+        JettonMasterStandardData,
+        JettonMasterStablecoinData,
+    ],
+)
+C = t.TypeVar(
+    "C",
+    bound=t.Union[
+        OnchainContent,
+        OffchainContent,
+    ],
+)
+
+
+DStandard = t.TypeVar("DStandard", bound=JettonMasterStandardData)
+DStablecoin = t.TypeVar("DStablecoin", bound=JettonMasterStablecoinData)
+
+CStandard = t.TypeVar("CStandard", bound=ContentLike)
+CStablecoin = t.TypeVar("CStablecoin", bound=OnchainContent)
+
+
+class BaseJettonMaster(BaseContract[D], t.Generic[D, C], abc.ABC):
+    _data_model: t.Type[D]
+
+    @property
+    def jetton_wallet_code(self) -> Cell:
+        return self.state_data.jetton_wallet_code
+
+    @property
+    def admin_address(self) -> Address:
+        return self.state_data.admin_address
+
+    @property
+    def total_supply(self) -> int:
+        return self.state_data.total_supply
+
+    @property
+    def content(self) -> C:
+        return self.state_data.content
+
+    @classmethod
+    @abc.abstractmethod
+    def _pack_jetton_wallet_data(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: t.Union[Cell, str],
+    ) -> Cell: ...
+
+    @classmethod
+    def calculate_user_jetton_wallet_address(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: t.Union[Cell, str],
+        workchain: WorkchainID = WorkchainID.BASECHAIN,
+    ) -> Address:
+        code = to_cell(jetton_wallet_code)
+        data = cls._pack_jetton_wallet_data(
+            owner_address=owner_address,
+            jetton_master_address=jetton_master_address,
+            jetton_wallet_code=code,
+        )
+        state_init = StateInit(code=code, data=data)
+        return Address((workchain.value, state_init.serialize().hash))
+
+    async def get_wallet_address(self, owner_address: AddressLike) -> Address:
+        return await JettonMasterGetMethods.get_wallet_address(
+            client=self.client,
+            address=self.address,
+            owner_address=owner_address,
+        )
+
+
+class JettonMasterStandard(BaseJettonMaster[DStandard, CStandard]):
+    _data_model = JettonMasterStandardData
+    VERSION = JettonMasterVersion.JettonMasterStandard
+
+    @classmethod
+    def _pack_jetton_wallet_data(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: Cell,
+        workchain: WorkchainID = WorkchainID.BASECHAIN,
+    ) -> Cell:
+        cell = begin_cell()
+        cell.store_coins(0)
+        cell.store_address(owner_address)
+        cell.store_address(jetton_master_address)
+        cell.store_ref(jetton_wallet_code)
+        return cell.end_cell()
+
+    async def get_jetton_data(self) -> t.Tuple[
+        int,
+        bool,
+        Address,
+        ContentLike,
+        Cell,
+    ]:
+        method_result = await JettonMasterGetMethods.get_jetton_data(
+            client=self.client,
+            address=self.address,
+        )
+        content_cs: Slice = method_result[3].begin_parse()
+        return (
+            method_result[0],
+            bool(method_result[1]),
+            method_result[2],
+            (
+                OnchainContent.deserialize(content_cs, False)
+                if content_cs.load_uint(8) == MetadataPrefix.ONCHAIN
+                else OffchainContent.deserialize(content_cs, False)
+            ),
+            method_result[4],
+        )
+
+
+class JettonMasterStablecoin(BaseJettonMaster[DStablecoin, CStablecoin]):
+    _data_model = JettonMasterStablecoinData
+    VERSION = JettonMasterVersion.JettonMasterStablecoin
+
+    @classmethod
+    def _pack_jetton_wallet_data(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: Cell,
+    ) -> Cell:
+        cell = begin_cell()
+        cell.store_uint(0, 4)
+        cell.store_coins(0)
+        cell.store_address(owner_address)
+        cell.store_address(jetton_master_address)
+        return cell.end_cell()
+
+    async def get_jetton_data(self) -> t.Tuple[
+        int,
+        bool,
+        Address,
+        OnchainContent,
+        Cell,
+    ]:
+        method_result = await JettonMasterGetMethods.get_jetton_data(
+            client=self.client,
+            address=self.address,
+        )
+        content_cs: Slice = method_result[3]
+        return (
+            method_result[0],
+            bool(method_result[1]),
+            method_result[2],
+            OnchainContent.deserialize(content_cs, True),
+            method_result[4],
+        )
+
+    async def get_next_admin_address(self) -> t.Optional[Address]:
+        return await JettonMasterGetMethods.get_next_admin_address(
+            client=self.client,
+            address=self.address,
+        )
+
+
+class JettonMasterStablecoinV2(JettonMasterStablecoin):
+    _SHARD_DEPTH: int = 8
+    VERSION = JettonMasterVersion.JettonMasterStablecoinV2
+
+    @classmethod
+    def _get_address_shard_prefix(cls, address: AddressLike) -> int:
+        if isinstance(address, str):
+            address = Address(address)
+        cs = address.to_cell().begin_parse()
+        return cs.skip_bits(3 + 8).preload_uint(8)
+
+    @classmethod
+    def _pack_jetton_wallet_data(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: Cell,
+    ) -> Cell:
+        cell = begin_cell()
+        cell.store_coins(0)
+        cell.store_address(owner_address)
+        cell.store_address(jetton_master_address)
+        return cell.end_cell()
+
+    @classmethod
+    def _calculate_jetton_wallet_state_init_cell(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: t.Union[Cell, str],
+    ) -> Cell:
+        code = to_cell(jetton_wallet_code)
+        data = cls._pack_jetton_wallet_data(
+            owner_address=owner_address,
+            jetton_master_address=jetton_master_address,
+            jetton_wallet_code=code,
+        )
+        cell = begin_cell()
+        cell.store_uint(1, 1)
+        cell.store_uint(cls._SHARD_DEPTH, 5)
+        cell.store_uint(0, 1)
+        cell.store_maybe_ref(code)
+        cell.store_maybe_ref(data)
+        cell.store_uint(0, 1)
+        return cell.end_cell()
+
+    @classmethod
+    def calculate_user_jetton_wallet_address(
+        cls,
+        owner_address: AddressLike,
+        jetton_master_address: AddressLike,
+        jetton_wallet_code: t.Union[Cell, str],
+        workchain: WorkchainID = WorkchainID.BASECHAIN,
+    ) -> Address:
+        state_init_cell = cls._calculate_jetton_wallet_state_init_cell(
+            owner_address=owner_address,
+            jetton_master_address=jetton_master_address,
+            jetton_wallet_code=jetton_wallet_code,
+        )
+        shard_prefix = cls._get_address_shard_prefix(owner_address)
+        mask = (1 << (256 - cls._SHARD_DEPTH)) - 1
+        prefix_less = cell_hash(state_init_cell) & mask
+        cell = begin_cell()
+        cell.store_uint(4, 3)
+        cell.store_int(workchain.value, 8)
+        cell.store_uint(shard_prefix, cls._SHARD_DEPTH)
+        cell.store_uint(prefix_less, 256 - cls._SHARD_DEPTH)
+        return cell.end_cell().begin_parse().load_address()

tonutils/contracts/jetton/wallet.py

@@ -0,0 +1,75 @@
+import typing as t
+
+from pytoniq_core import Address, Cell
+
+from .get_methods import JettonWalletGetMethods
+from ..base import BaseContract
+from ...types import (
+    JettonWalletStandardData,
+    JettonWalletStablecoinData,
+    JettonWalletStablecoinV2Data,
+    JettonWalletVersion,
+)
+
+D = t.TypeVar(
+    "D",
+    bound=t.Union[
+        JettonWalletStandardData,
+        JettonWalletStablecoinData,
+        JettonWalletStablecoinV2Data,
+    ],
+)
+
+
+class BaseJettonWallet(BaseContract[D]):
+    _data_model: t.Type[D]
+
+    @property
+    def jetton_balance(self) -> int:
+        return self.state_data.balance
+
+    @property
+    def owner_address(self) -> Address:
+        return self.state_data.owner_address
+
+    @property
+    def jetton_master_address(self) -> Address:
+        return self.state_data.jetton_master_address
+
+    async def get_wallet_data(self) -> t.Tuple[
+        int,
+        Address,
+        Address,
+        Cell,
+    ]:
+        method_result = await JettonWalletGetMethods.get_wallet_data(
+            client=self.client,
+            address=self.address,
+        )
+        return (
+            method_result[0],
+            method_result[1],
+            method_result[2],
+            method_result[3],
+        )
+
+
+class JettonWalletStandard(BaseJettonWallet[JettonWalletStandardData]):
+    _data_model = JettonWalletStandardData
+    VERSION = JettonWalletVersion.JettonWalletStandard
+
+
+class JettonWalletStablecoin(BaseJettonWallet[JettonWalletStablecoinData]):
+    _data_model = JettonWalletStablecoinData
+    VERSION = JettonWalletVersion.JettonWalletStablecoin
+
+    async def get_status(self) -> int:
+        return await JettonWalletGetMethods.get_status(
+            client=self.client,
+            address=self.address,
+        )
+
+
+class JettonWalletStablecoinV2(BaseJettonWallet[JettonWalletStablecoinV2Data]):
+    _data_model = JettonWalletStablecoinV2Data
+    VERSION = JettonWalletVersion.JettonWalletStablecoinV2

tonutils/contracts/nft/__init__.py

@@ -3,6 +3,10 @@ from .collection import (
     NFTCollectionEditable,
     NFTCollectionStandard,
 )
+from .get_methods import (
+    NFTCollectionGetMethods,
+    NFTItemGetMethods,
+)
 from .item import (
     BaseNFTItem,
     NFTItemEditable,
@@ -13,6 +17,8 @@ from .item import (
 __all__ = [
     "BaseNFTCollection",
     "BaseNFTItem",
+    "NFTCollectionGetMethods",
+    "NFTItemGetMethods",
     "NFTCollectionEditable",
     "NFTCollectionStandard",
     "NFTItemEditable",

tonutils/contracts/nft/collection.py

@@ -12,10 +12,10 @@ from .get_methods import NFTCollectionGetMethods
 from ..base import BaseContract
 from ...types import (
     AddressLike,
+    ContentLike,
     NFTCollectionContent,
     NFTCollectionData,
     NFTCollectionVersion,
-    NFTItemVersion,
     MetadataPrefix,
     OnchainContent,
     OffchainContent,
@@ -27,7 +27,6 @@ from ...utils import to_cell
 
 class BaseNFTCollection(BaseContract[NFTCollectionData]):
     _data_model = NFTCollectionData
-    NFT_ITEM_VERSION: NFTItemVersion
 
     @property
     def owner_address(self) -> Address:
@@ -62,7 +61,7 @@ class BaseNFTCollection(BaseContract[NFTCollectionData]):
 
     async def get_collection_data(self) -> t.Tuple[
         int,
-        t.Union[OnchainContent, OffchainContent],
+        ContentLike,
         t.Optional[Address],
     ]:
         method_result = await NFTCollectionGetMethods.get_collection_data(

tonutils/contracts/wallet/base.py

@@ -121,7 +121,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
             raise ContractError(
                 self,
                 f"Cannot sign message: "
-                f"`private_key` is not set for wallet `{self.VERSION.value}`.",
+                f"`private_key` is not set for wallet `{self.VERSION!r}`.",
             )
         signed_msg = await self._build_msg_cell(messages, params)
         signature = sign_message(signed_msg.hash, self._private_key.keypair.bytes)
@@ -205,7 +205,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
     async def transfer(
         self,
         destination: AddressLike,
-        value: int,
+        amount: int,
         body: t.Optional[t.Union[Cell, str]] = None,
         state_init: t.Optional[StateInit] = None,
         send_mode: t.Optional[t.Union[SendMode, int]] = None,
@@ -214,7 +214,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
     ) -> str:
         message = TransferMessage(
             destination=destination,
-            value=value,
+            amount=amount,
             body=body,
             state_init=state_init,
             send_mode=send_mode,
@@ -256,7 +256,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
         if not isinstance(config, cls._config_model):
             raise ContractError(
                 cls,
-                f"Invalid contract config type for `{cls.VERSION.value}`. "
+                f"Invalid contract config type for `{cls.VERSION!r}`. "
                 f"Expected {cls._config_model.__name__}, "
                 f"got {type(config).__name__}.",
             )
@@ -269,7 +269,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
         if params is not None and not isinstance(params, cls._params_model):
             raise ContractError(
                 cls,
-                f"Invalid params type for `{cls.VERSION.value}`. "
+                f"Invalid params type for `{cls.VERSION!r}`. "
                 f"Expected {cls._params_model.__name__}, "
                 f"got {type(params).__name__ if params is not None else 'None'}.",
             )
@@ -282,7 +282,7 @@ class BaseWallet(BaseContract, WalletProtocol[D, C, P], abc.ABC):
         if len(messages) > cls.MAX_MESSAGES:
             raise ContractError(
                 cls.__name__,
-                f"For `{cls.VERSION.value}`, "
+                f"For `{cls.VERSION!r}`, "
                 f"maximum messages amount is {cls.MAX_MESSAGES}, "
                 f"but got {len(messages)}.",
             )