refactor: refining codebase; cleanup for initial beta release

[aorumbayev]

Proposed Changes

• Refactored project structure and code organization across multiple modules
• Enhanced type safety with proper annotations and dedicated data classes
• Initial deprecation documentation at module levels
• Refining global exports to support legacy vs new project structure

Initial documentation for beta release is to follow in a subsequent PR

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
src/algokit_utils
_debugging.py	150	10	93%	21, 42, 81, 87, 96, 136, 164, 172–174
application_client.py	3	3	0%	1–11
config.py	89	18	80%	26–28, 41, 53, 84–85, 100, 105, 110, 118–123, 156, 158, 160
deploy.py	3	3	0%	1–10
logic_error.py	3	3	0%	1–10
src/algokit_utils/_legacy_v2
_ensure_funded.py	71	1	99%	100
_transfer.py	67	3	96%	13, 76–77
account.py	93	13	86%	15–18, 70–74, 109, 126, 156, 159, 208
application_client.py	532	77	86%	60–61, 178, 183, 212, 324, 329–330, 332, 334, 799, 814, 832–835, 925, 965, 977, 990, 1032, 1092–1098, 1102–1107, 1109, 1145, 1152, 1265, 1299, 1313, 1351–1353, 1355, 1365–1422, 1433–1438, 1458–1461
asset.py	82	5	94%	10, 28–31
common.py	13	1	92%	13
deploy.py	433	22	95%	32–35, 170, 174–175, 193, 249, 339–340, 361, 395, 406–414, 429, 437, 630–631, 655
network_clients.py	73	5	93%	77–78, 101–102, 135
src/algokit_utils/accounts
account_manager.py	206	35	83%	106–107, 121–126, 129–134, 147, 176–178, 191–192, 205, 210–214, 217, 240, 346, 437, 502, 507, 525, 528–529, 552
kmd_account_manager.py	71	8	89%	57–61, 110, 183, 190
src/algokit_utils/applications
abi.py	128	72	44%	55, 70–71, 77, 83, 85, 87, 91–92, 99–118, 127, 130–136, 144–157, 163–175, 183–194
app_client.py	717	211	71%	56–66, 123, 131, 319–322, 325, 328, 331, 334, 346–349, 352, 355, 358, 361, 373, 382, 391, 396–458, 471–529, 562–564, 573–576, 579–580, 583–586, 589–590, 593–594, 597–598, 611, 673–674, 703, 706, 709, 712, 715, 718, 731, 734, 737, 740, 743, 746, 775–780, 783, 788, 793, 798, 803, 818, 841, 931, 960–961, 980, 982, 988, 1018–1026, 1048–1051, 1054–1057, 1078, 1114, 1127, 1198–1205, 1230, 1242, 1244, 1247, 1251, 1303, 1355, 1373–1374, 1412, 1423–1425, 1429–1453, 1464, 1473–1484, 1492–1497
app_deployer.py	214	39	82%	206, 213, 223–228, 231–235, 273–287, 302–303, 492–505, 515, 520, 526, 532–534, 541, 555, 566–604
app_factory.py	271	27	90%	334, 344, 347, 481, 489, 501, 647, 661–666, 672–673, 692, 717, 728–729, 765, 773–787
app_manager.py	211	14	93%	191, 221–222, 239–244, 265, 301, 314–317, 329, 337
src/algokit_utils/applications/app_spec
arc32.py	95	8	92%	195–204
arc56.py	470	36	92%	66–68, 140, 223, 234–235, 283, 296–298, 330, 339, 341, 383, 545, 555, 559, 697, 699, 732–743, 756, 758–759, 775
src/algokit_utils/assets
asset_manager.py	127	12	91%	223–224, 233, 239–254, 264
src/algokit_utils/clients
algorand_client.py	91	13	86%	59–60, 69–70, 93–95, 104–105, 199, 215, 228, 238
client_manager.py	148	37	75%	53–60, 66, 90–92, 122, 127–130, 144, 171, 195–198, 220, 244, 256, 270, 286–311, 337, 349, 358
dispenser_api_client.py	83	12	86%	126–127, 131–134, 169–171, 190–192
src/algokit_utils/errors
logic_error.py	56	12	79%	14, 38, 105–121
src/algokit_utils/models
account.py	63	6	90%	81, 86, 107–114
amount.py	115	56	51%	22, 34, 38, 62, 67–70, 74, 77–83, 90, 93–97, 100–104, 107–111, 114–118, 121–125, 128–134, 137–140, 143–149
application.py	42	1	98%	8
state.py	36	5	86%	51, 55–58
transaction.py	55	4	93%	56, 66, 86, 91
src/algokit_utils/protocols
client.py	23	6	74%	6–11
src/algokit_utils/transactions
transaction_composer.py	567	52	91%	28–37, 608, 650, 806–807, 833–834, 870, 1020, 1025, 1054–1092, 1212, 1215, 1323, 1325–1326, 1375–1376
transaction_creator.py	72	6	92%	119, 124, 129, 134, 139, 144
transaction_sender.py	145	10	93%	82, 204, 245–246, 335–340, 345–346, 370
utils.py	202	68	66%	31, 45, 52, 76, 78, 80, 97, 103, 131–194, 223, 241–243, 249–264, 271–278, 281–288, 299, 367, 370, 375, 379–390
TOTAL	6024	914	85%

Tests	Skipped	Failures	Errors	Time
353	0 💤	0 ❌	0 🔥	3m 13s ⏱️