@thru/programs 0.3.4 → 0.3.5

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 (118) hide show
  1. package/README.md +123 -37
  2. package/dist/abi-manager/index.cjs +9568 -0
  3. package/dist/abi-manager/index.cjs.map +1 -0
  4. package/dist/abi-manager/index.d.cts +2169 -0
  5. package/dist/abi-manager/index.d.ts +2169 -0
  6. package/dist/abi-manager/index.js +4 -0
  7. package/dist/abi-manager/index.js.map +1 -0
  8. package/dist/amm/index.cjs +1 -3
  9. package/dist/amm/index.cjs.map +1 -1
  10. package/dist/amm/index.d.cts +1 -1
  11. package/dist/amm/index.d.ts +1 -1
  12. package/dist/amm/index.js +2 -2
  13. package/dist/amm/index.js.map +1 -1
  14. package/dist/chunk-6IC6CO5S.js +9443 -0
  15. package/dist/chunk-6IC6CO5S.js.map +1 -0
  16. package/dist/chunk-7FBCBZIY.js +41 -0
  17. package/dist/chunk-7FBCBZIY.js.map +1 -0
  18. package/dist/chunk-BNYDH4ZP.js +4351 -0
  19. package/dist/chunk-BNYDH4ZP.js.map +1 -0
  20. package/dist/chunk-OODN6LJA.js +6567 -0
  21. package/dist/chunk-OODN6LJA.js.map +1 -0
  22. package/dist/chunk-YX7BLFQZ.js +81 -0
  23. package/dist/chunk-YX7BLFQZ.js.map +1 -0
  24. package/dist/clob/index.cjs +6674 -3209
  25. package/dist/clob/index.cjs.map +1 -1
  26. package/dist/clob/index.d.cts +1114 -52
  27. package/dist/clob/index.d.ts +1114 -52
  28. package/dist/clob/index.js +6812 -3393
  29. package/dist/clob/index.js.map +1 -1
  30. package/dist/deploy/index.cjs +24734 -0
  31. package/dist/deploy/index.cjs.map +1 -0
  32. package/dist/deploy/index.d.cts +180 -0
  33. package/dist/deploy/index.d.ts +180 -0
  34. package/dist/deploy/index.js +1846 -0
  35. package/dist/deploy/index.js.map +1 -0
  36. package/dist/helpers-DD7q61nr.d.cts +7 -0
  37. package/dist/helpers-DD7q61nr.d.ts +7 -0
  38. package/dist/manager/index.cjs +6680 -0
  39. package/dist/manager/index.cjs.map +1 -0
  40. package/dist/manager/index.d.cts +1279 -0
  41. package/dist/manager/index.d.ts +1279 -0
  42. package/dist/manager/index.js +4 -0
  43. package/dist/manager/index.js.map +1 -0
  44. package/dist/passkey-manager/index.cjs +4 -5
  45. package/dist/passkey-manager/index.cjs.map +1 -1
  46. package/dist/passkey-manager/index.js +2 -2
  47. package/dist/uploader/index.cjs +4442 -0
  48. package/dist/uploader/index.cjs.map +1 -0
  49. package/dist/uploader/index.d.cts +761 -0
  50. package/dist/uploader/index.d.ts +761 -0
  51. package/dist/uploader/index.js +4 -0
  52. package/dist/uploader/index.js.map +1 -0
  53. package/package.json +22 -2
  54. package/src/abi-manager/abi/thru/blockchain/state_proof/types.ts +1906 -0
  55. package/src/abi-manager/abi/thru/common/primitives/types.ts +2428 -0
  56. package/src/abi-manager/abi/thru/program/abi_manager/types.ts +7037 -0
  57. package/src/abi-manager/accounts.ts +91 -0
  58. package/src/abi-manager/constants.ts +19 -0
  59. package/src/abi-manager/derivation.ts +86 -0
  60. package/src/abi-manager/errors.ts +48 -0
  61. package/src/abi-manager/index.test.ts +136 -0
  62. package/src/abi-manager/index.ts +56 -0
  63. package/src/abi-manager/instructions.ts +573 -0
  64. package/src/abi-manager/types.ts +150 -0
  65. package/src/amm/index.test.ts +8 -2
  66. package/src/amm/index.ts +1 -1
  67. package/src/clob/abi/thru/program/clob/types.ts +6981 -3070
  68. package/src/clob/exchange-client.test.ts +115 -2
  69. package/src/clob/exchange-client.ts +52 -13
  70. package/src/clob/exchange.test.ts +18 -16
  71. package/src/clob/exchange.ts +4 -0
  72. package/src/clob/index.test.ts +134 -7
  73. package/src/clob/index.ts +302 -10
  74. package/src/clob/price.test.ts +32 -0
  75. package/src/clob/price.ts +77 -0
  76. package/src/deploy/accounts.ts +208 -0
  77. package/src/deploy/chain.ts +163 -0
  78. package/src/deploy/constants.ts +25 -0
  79. package/src/deploy/deploy.test.ts +349 -0
  80. package/src/deploy/errors.ts +72 -0
  81. package/src/deploy/index.ts +44 -0
  82. package/src/deploy/inspection.ts +146 -0
  83. package/src/deploy/seeds.ts +29 -0
  84. package/src/deploy/types.ts +178 -0
  85. package/src/deploy/uploader.test.ts +326 -0
  86. package/src/deploy/uploader.ts +558 -0
  87. package/src/deploy/validation-imports.test.ts +55 -0
  88. package/src/deploy/validation.ts +183 -0
  89. package/src/deploy/workflows.test.ts +422 -0
  90. package/src/deploy/workflows.ts +1088 -0
  91. package/src/helpers/bytes.test.ts +58 -0
  92. package/src/helpers/bytes.ts +28 -3
  93. package/src/manager/abi/thru/blockchain/state_proof/types.ts +1906 -0
  94. package/src/manager/abi/thru/common/primitives/types.ts +2428 -0
  95. package/src/manager/abi/thru/program/manager/types.ts +3814 -0
  96. package/src/manager/accounts.ts +44 -0
  97. package/src/manager/constants.ts +16 -0
  98. package/src/manager/derivation.ts +32 -0
  99. package/src/manager/errors.ts +47 -0
  100. package/src/manager/index.test.ts +108 -0
  101. package/src/manager/index.ts +68 -0
  102. package/src/manager/instructions.ts +281 -0
  103. package/src/manager/types.ts +95 -0
  104. package/src/manager/validation.ts +35 -0
  105. package/src/uploader/abi/thru/common/primitives/types.ts +2428 -0
  106. package/src/uploader/abi/thru/program/uploader/types.ts +3022 -0
  107. package/src/uploader/accounts.ts +38 -0
  108. package/src/uploader/constants.ts +14 -0
  109. package/src/uploader/derivation.ts +34 -0
  110. package/src/uploader/errors.ts +25 -0
  111. package/src/uploader/index.test.ts +107 -0
  112. package/src/uploader/index.ts +34 -0
  113. package/src/uploader/instructions.ts +163 -0
  114. package/src/uploader/types.ts +67 -0
  115. package/src/utils/helpers.ts +121 -0
  116. package/tsup.config.ts +4 -0
  117. package/dist/chunk-P5OABVJI.js +0 -28
  118. package/dist/chunk-P5OABVJI.js.map +0 -1
@@ -0,0 +1,180 @@
1
+ import { Thru } from '@thru/sdk/client';
2
+
3
+ type DeploymentBytes = Uint8Array | ArrayBuffer | ArrayBufferView;
4
+ type DeploymentPrivateKey = Uint8Array | string;
5
+ interface DeploymentSigner {
6
+ address: string;
7
+ privateKey: DeploymentPrivateKey;
8
+ }
9
+ type DeploymentOperation = "deployProgram" | "deployProgramABI" | "upgradeProgram" | "upgradeProgramABI";
10
+ type DeployProgressPhase = "validation" | "preflight" | "upload" | "commit" | "verification" | "cleanup";
11
+ type DeployProgressStatus = "started" | "progress" | "succeeded" | "failed";
12
+ interface DeployProgressEvent {
13
+ operation: DeploymentOperation;
14
+ phase: DeployProgressPhase;
15
+ status: DeployProgressStatus;
16
+ artifact?: "program" | "abi";
17
+ uploadStep?: "create" | "write" | "finalize";
18
+ completedChunks?: number;
19
+ totalChunks?: number;
20
+ signature?: string;
21
+ message?: string;
22
+ }
23
+ interface DeploymentRequestBase {
24
+ seed: string;
25
+ signer: DeploymentSigner;
26
+ client?: Thru;
27
+ ephemeral?: boolean;
28
+ chunkSize?: number;
29
+ onProgress?: (event: DeployProgressEvent) => void;
30
+ }
31
+ interface ProgramMutationRequest extends DeploymentRequestBase {
32
+ program: DeploymentBytes;
33
+ abi?: DeploymentBytes;
34
+ }
35
+ interface ProgramABIMutationRequest extends DeploymentRequestBase {
36
+ abi: DeploymentBytes;
37
+ programAddress?: string;
38
+ }
39
+ type DeployProgramRequest = ProgramMutationRequest;
40
+ type DeployProgramABIRequest = ProgramABIMutationRequest;
41
+ type UpgradeProgramRequest = ProgramMutationRequest & {
42
+ programAddress?: string;
43
+ };
44
+ type UpgradeProgramABIRequest = ProgramABIMutationRequest;
45
+ type UploadCleanupResult = {
46
+ status: "succeeded";
47
+ transactionSignature: string;
48
+ } | {
49
+ status: "not-needed";
50
+ } | {
51
+ status: "failed";
52
+ error: string;
53
+ transactionSignature?: string;
54
+ remainingAccountAddresses?: string[];
55
+ };
56
+ interface UploadArtifactResult {
57
+ artifact: "program" | "abi";
58
+ size: number;
59
+ sha256: string;
60
+ metaAccountAddress: string;
61
+ bufferAccountAddress: string;
62
+ reused: boolean;
63
+ transactionSignatures: string[];
64
+ cleanup: UploadCleanupResult;
65
+ }
66
+ interface ManagedProgramResultBase {
67
+ seed: string;
68
+ ephemeral: boolean;
69
+ authorityAddress: string;
70
+ programMetaAccountAddress: string;
71
+ programAccountAddress: string;
72
+ programVersion: bigint;
73
+ transactionSignature: string;
74
+ warnings: string[];
75
+ }
76
+ interface ABIResultFields {
77
+ abiMetaAccountAddress: string;
78
+ abiAccountAddress: string;
79
+ abiRevision: bigint;
80
+ }
81
+ interface ProgramMutationResult extends ManagedProgramResultBase {
82
+ programSize: number;
83
+ abiSize?: number;
84
+ abiMetaAccountAddress?: string;
85
+ abiAccountAddress?: string;
86
+ abiRevision?: bigint;
87
+ programUpload: UploadArtifactResult;
88
+ abiUpload?: UploadArtifactResult;
89
+ }
90
+ interface ProgramABIMutationResult extends ManagedProgramResultBase, ABIResultFields {
91
+ abiSize: number;
92
+ abiUpload: UploadArtifactResult;
93
+ }
94
+ type DeployProgramResult = ProgramMutationResult;
95
+ type DeployProgramABIResult = ProgramABIMutationResult;
96
+ type UpgradeProgramResult = ProgramMutationResult;
97
+ type UpgradeProgramABIResult = ProgramABIMutationResult;
98
+ interface InspectProgramDeploymentRequest {
99
+ client: Thru;
100
+ seed: string;
101
+ ephemeral?: boolean;
102
+ authorityAddress?: string;
103
+ expectedProgramBytes?: Uint8Array;
104
+ inspectABI?: boolean;
105
+ expectedABIBytes?: Uint8Array;
106
+ }
107
+ interface MissingAccountPair {
108
+ status: "missing";
109
+ metadataPresent: false;
110
+ accountPresent: false;
111
+ }
112
+ interface PartialAccountPair {
113
+ status: "partial";
114
+ metadataPresent: boolean;
115
+ accountPresent: boolean;
116
+ }
117
+ type ProgramAccountInspection = MissingAccountPair | PartialAccountPair | {
118
+ status: "present";
119
+ metadataPresent: true;
120
+ accountPresent: true;
121
+ authorityAddress: string;
122
+ version: bigint;
123
+ state: number;
124
+ bytesMatch?: boolean;
125
+ };
126
+ type ABIAccountInspection = MissingAccountPair | PartialAccountPair | {
127
+ status: "present";
128
+ metadataPresent: true;
129
+ accountPresent: true;
130
+ revision: bigint;
131
+ state: number;
132
+ bytesMatch?: boolean;
133
+ };
134
+ interface ProgramDeploymentInspection {
135
+ programMetaAccountAddress: string;
136
+ programAccountAddress: string;
137
+ abiMetaAccountAddress: string;
138
+ abiAccountAddress: string;
139
+ program: ProgramAccountInspection;
140
+ abi?: ABIAccountInspection;
141
+ }
142
+
143
+ type DeployErrorCode = "INVALID_INPUT" | "SIGNER_MISMATCH" | "TARGET_EXISTS" | "TARGET_NOT_FOUND" | "TARGET_FINALIZED" | "UPLOAD_CONFLICT" | "TRANSACTION_FAILED" | "VERIFICATION_FAILED" | "OUTCOME_UNKNOWN" | "RPC_ERROR";
144
+ interface DeployErrorOptions {
145
+ operation?: DeploymentOperation;
146
+ phase?: DeployProgressPhase;
147
+ transactionSignature?: string;
148
+ vmError?: number;
149
+ userErrorCode?: bigint;
150
+ addresses?: Record<string, string>;
151
+ cleanup?: UploadCleanupResult[];
152
+ cause?: unknown;
153
+ }
154
+ declare class DeployError extends Error {
155
+ readonly code: DeployErrorCode;
156
+ readonly operation?: DeploymentOperation;
157
+ readonly phase?: DeployProgressPhase;
158
+ readonly transactionSignature?: string;
159
+ readonly vmError?: number;
160
+ readonly userErrorCode?: bigint;
161
+ addresses?: Record<string, string>;
162
+ cleanup?: UploadCleanupResult[];
163
+ constructor(code: DeployErrorCode, message: string, options?: DeployErrorOptions);
164
+ }
165
+
166
+ declare function deployProgram(request: DeployProgramRequest): Promise<DeployProgramResult>;
167
+ declare function deployProgramABI(request: DeployProgramABIRequest): Promise<DeployProgramABIResult>;
168
+ declare function upgradeProgram(request: UpgradeProgramRequest): Promise<UpgradeProgramResult>;
169
+ declare function upgradeProgramABI(request: UpgradeProgramABIRequest): Promise<UpgradeProgramABIResult>;
170
+
171
+ declare function inspectProgramDeployment(request: InspectProgramDeploymentRequest): Promise<ProgramDeploymentInspection>;
172
+
173
+ declare const deploy: Readonly<{
174
+ deployProgram: typeof deployProgram;
175
+ deployProgramABI: typeof deployProgramABI;
176
+ upgradeProgram: typeof upgradeProgram;
177
+ upgradeProgramABI: typeof upgradeProgramABI;
178
+ }>;
179
+
180
+ export { type ABIAccountInspection, DeployError, type DeployErrorCode, type DeployErrorOptions, type DeployProgramABIRequest, type DeployProgramABIResult, type DeployProgramRequest, type DeployProgramResult, type DeployProgressEvent, type DeploymentBytes, type DeploymentPrivateKey, type DeploymentRequestBase, type DeploymentSigner, type InspectProgramDeploymentRequest, type ProgramAccountInspection, type ProgramDeploymentInspection, type UpgradeProgramABIRequest, type UpgradeProgramABIResult, type UpgradeProgramRequest, type UpgradeProgramResult, type UploadArtifactResult, type UploadCleanupResult, deploy, deployProgram, deployProgramABI, inspectProgramDeployment, upgradeProgram, upgradeProgramABI };
@@ -0,0 +1,180 @@
1
+ import { Thru } from '@thru/sdk/client';
2
+
3
+ type DeploymentBytes = Uint8Array | ArrayBuffer | ArrayBufferView;
4
+ type DeploymentPrivateKey = Uint8Array | string;
5
+ interface DeploymentSigner {
6
+ address: string;
7
+ privateKey: DeploymentPrivateKey;
8
+ }
9
+ type DeploymentOperation = "deployProgram" | "deployProgramABI" | "upgradeProgram" | "upgradeProgramABI";
10
+ type DeployProgressPhase = "validation" | "preflight" | "upload" | "commit" | "verification" | "cleanup";
11
+ type DeployProgressStatus = "started" | "progress" | "succeeded" | "failed";
12
+ interface DeployProgressEvent {
13
+ operation: DeploymentOperation;
14
+ phase: DeployProgressPhase;
15
+ status: DeployProgressStatus;
16
+ artifact?: "program" | "abi";
17
+ uploadStep?: "create" | "write" | "finalize";
18
+ completedChunks?: number;
19
+ totalChunks?: number;
20
+ signature?: string;
21
+ message?: string;
22
+ }
23
+ interface DeploymentRequestBase {
24
+ seed: string;
25
+ signer: DeploymentSigner;
26
+ client?: Thru;
27
+ ephemeral?: boolean;
28
+ chunkSize?: number;
29
+ onProgress?: (event: DeployProgressEvent) => void;
30
+ }
31
+ interface ProgramMutationRequest extends DeploymentRequestBase {
32
+ program: DeploymentBytes;
33
+ abi?: DeploymentBytes;
34
+ }
35
+ interface ProgramABIMutationRequest extends DeploymentRequestBase {
36
+ abi: DeploymentBytes;
37
+ programAddress?: string;
38
+ }
39
+ type DeployProgramRequest = ProgramMutationRequest;
40
+ type DeployProgramABIRequest = ProgramABIMutationRequest;
41
+ type UpgradeProgramRequest = ProgramMutationRequest & {
42
+ programAddress?: string;
43
+ };
44
+ type UpgradeProgramABIRequest = ProgramABIMutationRequest;
45
+ type UploadCleanupResult = {
46
+ status: "succeeded";
47
+ transactionSignature: string;
48
+ } | {
49
+ status: "not-needed";
50
+ } | {
51
+ status: "failed";
52
+ error: string;
53
+ transactionSignature?: string;
54
+ remainingAccountAddresses?: string[];
55
+ };
56
+ interface UploadArtifactResult {
57
+ artifact: "program" | "abi";
58
+ size: number;
59
+ sha256: string;
60
+ metaAccountAddress: string;
61
+ bufferAccountAddress: string;
62
+ reused: boolean;
63
+ transactionSignatures: string[];
64
+ cleanup: UploadCleanupResult;
65
+ }
66
+ interface ManagedProgramResultBase {
67
+ seed: string;
68
+ ephemeral: boolean;
69
+ authorityAddress: string;
70
+ programMetaAccountAddress: string;
71
+ programAccountAddress: string;
72
+ programVersion: bigint;
73
+ transactionSignature: string;
74
+ warnings: string[];
75
+ }
76
+ interface ABIResultFields {
77
+ abiMetaAccountAddress: string;
78
+ abiAccountAddress: string;
79
+ abiRevision: bigint;
80
+ }
81
+ interface ProgramMutationResult extends ManagedProgramResultBase {
82
+ programSize: number;
83
+ abiSize?: number;
84
+ abiMetaAccountAddress?: string;
85
+ abiAccountAddress?: string;
86
+ abiRevision?: bigint;
87
+ programUpload: UploadArtifactResult;
88
+ abiUpload?: UploadArtifactResult;
89
+ }
90
+ interface ProgramABIMutationResult extends ManagedProgramResultBase, ABIResultFields {
91
+ abiSize: number;
92
+ abiUpload: UploadArtifactResult;
93
+ }
94
+ type DeployProgramResult = ProgramMutationResult;
95
+ type DeployProgramABIResult = ProgramABIMutationResult;
96
+ type UpgradeProgramResult = ProgramMutationResult;
97
+ type UpgradeProgramABIResult = ProgramABIMutationResult;
98
+ interface InspectProgramDeploymentRequest {
99
+ client: Thru;
100
+ seed: string;
101
+ ephemeral?: boolean;
102
+ authorityAddress?: string;
103
+ expectedProgramBytes?: Uint8Array;
104
+ inspectABI?: boolean;
105
+ expectedABIBytes?: Uint8Array;
106
+ }
107
+ interface MissingAccountPair {
108
+ status: "missing";
109
+ metadataPresent: false;
110
+ accountPresent: false;
111
+ }
112
+ interface PartialAccountPair {
113
+ status: "partial";
114
+ metadataPresent: boolean;
115
+ accountPresent: boolean;
116
+ }
117
+ type ProgramAccountInspection = MissingAccountPair | PartialAccountPair | {
118
+ status: "present";
119
+ metadataPresent: true;
120
+ accountPresent: true;
121
+ authorityAddress: string;
122
+ version: bigint;
123
+ state: number;
124
+ bytesMatch?: boolean;
125
+ };
126
+ type ABIAccountInspection = MissingAccountPair | PartialAccountPair | {
127
+ status: "present";
128
+ metadataPresent: true;
129
+ accountPresent: true;
130
+ revision: bigint;
131
+ state: number;
132
+ bytesMatch?: boolean;
133
+ };
134
+ interface ProgramDeploymentInspection {
135
+ programMetaAccountAddress: string;
136
+ programAccountAddress: string;
137
+ abiMetaAccountAddress: string;
138
+ abiAccountAddress: string;
139
+ program: ProgramAccountInspection;
140
+ abi?: ABIAccountInspection;
141
+ }
142
+
143
+ type DeployErrorCode = "INVALID_INPUT" | "SIGNER_MISMATCH" | "TARGET_EXISTS" | "TARGET_NOT_FOUND" | "TARGET_FINALIZED" | "UPLOAD_CONFLICT" | "TRANSACTION_FAILED" | "VERIFICATION_FAILED" | "OUTCOME_UNKNOWN" | "RPC_ERROR";
144
+ interface DeployErrorOptions {
145
+ operation?: DeploymentOperation;
146
+ phase?: DeployProgressPhase;
147
+ transactionSignature?: string;
148
+ vmError?: number;
149
+ userErrorCode?: bigint;
150
+ addresses?: Record<string, string>;
151
+ cleanup?: UploadCleanupResult[];
152
+ cause?: unknown;
153
+ }
154
+ declare class DeployError extends Error {
155
+ readonly code: DeployErrorCode;
156
+ readonly operation?: DeploymentOperation;
157
+ readonly phase?: DeployProgressPhase;
158
+ readonly transactionSignature?: string;
159
+ readonly vmError?: number;
160
+ readonly userErrorCode?: bigint;
161
+ addresses?: Record<string, string>;
162
+ cleanup?: UploadCleanupResult[];
163
+ constructor(code: DeployErrorCode, message: string, options?: DeployErrorOptions);
164
+ }
165
+
166
+ declare function deployProgram(request: DeployProgramRequest): Promise<DeployProgramResult>;
167
+ declare function deployProgramABI(request: DeployProgramABIRequest): Promise<DeployProgramABIResult>;
168
+ declare function upgradeProgram(request: UpgradeProgramRequest): Promise<UpgradeProgramResult>;
169
+ declare function upgradeProgramABI(request: UpgradeProgramABIRequest): Promise<UpgradeProgramABIResult>;
170
+
171
+ declare function inspectProgramDeployment(request: InspectProgramDeploymentRequest): Promise<ProgramDeploymentInspection>;
172
+
173
+ declare const deploy: Readonly<{
174
+ deployProgram: typeof deployProgram;
175
+ deployProgramABI: typeof deployProgramABI;
176
+ upgradeProgram: typeof upgradeProgram;
177
+ upgradeProgramABI: typeof upgradeProgramABI;
178
+ }>;
179
+
180
+ export { type ABIAccountInspection, DeployError, type DeployErrorCode, type DeployErrorOptions, type DeployProgramABIRequest, type DeployProgramABIResult, type DeployProgramRequest, type DeployProgramResult, type DeployProgressEvent, type DeploymentBytes, type DeploymentPrivateKey, type DeploymentRequestBase, type DeploymentSigner, type InspectProgramDeploymentRequest, type ProgramAccountInspection, type ProgramDeploymentInspection, type UpgradeProgramABIRequest, type UpgradeProgramABIResult, type UpgradeProgramRequest, type UpgradeProgramResult, type UploadArtifactResult, type UploadCleanupResult, deploy, deployProgram, deployProgramABI, inspectProgramDeployment, upgradeProgram, upgradeProgramABI };