@qorechain/svm 0.4.0 → 0.5.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work, excluding
+          those notices that do not pertain to any part of the Derivative
+          Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one of
+          the following places: within a NOTICE text file distributed as
+          part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do
+          not modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 QoreChain
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.cjs

@@ -269,7 +269,7 @@ var fees = {
 };
 
 // src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.5.0";
 
 exports.ASSOCIATED_TOKEN_PROGRAM_ID = ASSOCIATED_TOKEN_PROGRAM_ID;
 exports.DEFAULT_SVM_RPC_URL = DEFAULT_SVM_RPC_URL;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/programs.ts","../src/wallet.ts","../src/errors.ts","../src/subscribe.ts","../src/fees.ts","../src/index.ts"],"names":["Connection","Transaction","SystemProgram","sendAndConfirmTransaction","Keypair","PublicKey","TransactionInstruction","ComputeBudgetProgram","fees"],"mappings":";;;;;AAmCO,IAAM,mBAAA,GAAsB;AA2EnC,SAAS,kBAAkB,IAAA,EAA0C;AACnE,EAAA,IAAI,IAAA,CAAK,UAAA,EAAY,OAAO,IAAA,CAAK,UAAA;AACjC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,MAAA,IAAU,IAAA,CAAK,WAAW,MAAA,IAAU,mBAAA;AACrD,EAAA,OAAO,IAAIA,kBAAA,CAAW,GAAA,EAAK,IAAA,CAAK,cAAc,WAAW,CAAA;AAC3D;AAQO,SAAS,eAAA,CAAgB,IAAA,GAA+B,EAAC,EAAc;AAC5E,EAAA,MAAM,UAAA,GAAa,kBAAkB,IAAI,CAAA;AAEzC,EAAA,MAAM,gBAAA,GAAmB,CAAC,IAAA,KAAuC;AAC/D,IAAA,MAAM,EAAA,GAAK,IAAIC,mBAAA,EAAY;AAC3B,IAAA,EAAA,CAAG,GAAA;AAAA,MACDC,sBAAc,QAAA,CAAS;AAAA,QACrB,UAAA,EAAY,KAAK,IAAA,CAAK,SAAA;AAAA,QACtB,UAAU,IAAA,CAAK,EAAA;AAAA,QACf,UAAU,IAAA,CAAK;AAAA,OAChB;AAAA,KACH;AACA,IAAA,OAAO,EAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,eAAA,GAAkB,CACtB,EAAA,EACA,OAAA,EACA,YACoBC,iCAAA,CAA0B,UAAA,EAAY,EAAA,EAAI,OAAA,EAAS,OAAO,CAAA;AAEhF,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IAEA,YAAY,CAAC,MAAA,EAAQ,eAAe,UAAA,CAAW,UAAA,CAAW,QAAQ,UAAU,CAAA;AAAA,IAC5E,gBAAgB,CAAC,MAAA,EAAQ,eACvB,UAAA,CAAW,cAAA,CAAe,QAAQ,UAAU,CAAA;AAAA,IAC9C,kBAAA,EAAoB,CAAC,kBAAA,KACnB,UAAA,CAAW,mBAAmB,kBAAkB,CAAA;AAAA,IAClD,uBAAA,EAAyB,CAAC,KAAA,EAAO,MAAA,EAAQ,eACvC,UAAA,CAAW,uBAAA,CAAwB,KAAA,EAAO,MAAA,EAAQ,UAAU,CAAA;AAAA,IAC9D,yBAAyB,CAAC,OAAA,EAAS,YACjC,UAAA,CAAW,uBAAA,CAAwB,SAAS,OAAO,CAAA;AAAA,IACrD,gBAAgB,CAAC,MAAA,EAAQ,aAAa,UAAA,CAAW,cAAA,CAAe,QAAQ,QAAQ,CAAA;AAAA,IAEhF,gBAAA;AAAA,IACA,WAAA,EAAa,CAAC,IAAA,EAAM,OAAA,KAClB,eAAA,CAAgB,gBAAA,CAAiB,IAAI,CAAA,EAAG,CAAC,IAAA,CAAK,IAAI,CAAA,EAAG,OAAO,CAAA;AAAA,IAC9D,eAAA;AAAA,IACA,qBAAqB,CAAC,EAAA;AAAA;AAAA;AAAA,MAKnB,UAAA,CAAW,oBAEuD,EAAE;AAAA;AAAA,GACzE;AACF;ACzJO,SAAS,wBAAwB,SAAA,EAAgC;AACtE,EAAA,IAAI,SAAA,CAAU,WAAW,EAAA,EAAI;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,4DAAA,EAA+D,UAAU,MAAM,CAAA;AAAA,KACjF;AAAA,EACF;AACA,EAAA,OAAOC,eAAA,CAAQ,cAAc,SAAS,CAAA;AACxC;AAGO,SAAS,WAAW,GAAA,EAAkC;AAC3D,EAAA,MAAM,MAAA,GAAS,GAAA,YAAeC,iBAAAA,GAAY,GAAA,GAAM,GAAA,CAAI,SAAA;AACpD,EAAA,OAAO,OAAO,QAAA,EAAS;AACzB;ACfO,IAAM,iBAAA,GAAoB,IAAIA,iBAAAA,CAAU,kCAAkC;AAG1E,IAAM,gBAAA,GAAmB,IAAIA,iBAAAA,CAAU,6CAA6C;AAGpF,IAAM,8BAA8B,IAAIA,iBAAAA;AAAA,EAC7C;AACF;AAGO,IAAM,eAAA,GAAkB,IAAIA,iBAAAA,CAAU,6CAA6C;AAGnF,IAAM,WAAA,GAAc;AAAA,EACzB,MAAA,EAAQ,iBAAA;AAAA,EACR,KAAA,EAAO,gBAAA;AAAA,EACP,eAAA,EAAiB,2BAAA;AAAA,EACjB,IAAA,EAAM;AACR;AASO,SAAS,qBAAA,CACd,IAAA,EACA,OAAA,GAAuB,EAAC,EACA;AACxB,EAAA,OAAO,IAAIC,8BAAA,CAAuB;AAAA,IAChC,SAAA,EAAW,eAAA;AAAA,IACX,IAAA,EAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,MAAA,EAAQ,QAAA,EAAU,IAAA,EAAM,UAAA,EAAY,KAAA,EAAM,CAAE,CAAA;AAAA,IAC7E,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,IAAA,EAAM,MAAM;AAAA,GAC/B,CAAA;AACH;AAsBO,SAAS,+BACd,IAAA,EACwB;AACxB,EAAA,MAAM,EAAE,QAAQ,WAAA,EAAa,KAAA,EAAO,QAAQ,YAAA,GAAe,IAAG,GAAI,IAAA;AAElE,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA;AAC3B,EAAA,IAAA,CAAK,UAAA,CAAW,GAAG,CAAC,CAAA;AACpB,EAAA,IAAA,CAAK,gBAAA,CAAiB,QAAQ,CAAC,CAAA;AAE/B,EAAA,MAAM,IAAA,GAAsB;AAAA,IAC1B,EAAE,MAAA,EAAQ,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACpD,EAAE,MAAA,EAAQ,WAAA,EAAa,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACzD;AAAA,MACE,MAAA,EAAQ,KAAA;AAAA,MACR,QAAA,EAAU,aAAa,MAAA,KAAW,CAAA;AAAA,MAClC,UAAA,EAAY;AAAA,KACd;AAAA,IACA,GAAG,YAAA,CAAa,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,MAAA,EAAQ,QAAA,EAAU,IAAA,EAAM,UAAA,EAAY,KAAA,EAAM,CAAE;AAAA,GACjF;AAEA,EAAA,OAAO,IAAIA,8BAAA,CAAuB,EAAE,WAAW,gBAAA,EAAkB,IAAA,EAAM,MAAM,CAAA;AAC/E;AAMO,SAAS,yBAAA,CACd,IAAA,EACA,KAAA,EACA,cAAA,GAA4B,gBAAA,EACjB;AACX,EAAA,MAAM,CAAC,OAAO,CAAA,GAAID,iBAAAA,CAAU,sBAAA;AAAA,IAC1B,CAAC,MAAM,QAAA,EAAS,EAAG,eAAe,QAAA,EAAS,EAAG,IAAA,CAAK,QAAA,EAAU,CAAA;AAAA,IAC7D;AAAA,GACF;AACA,EAAA,OAAO,OAAA;AACT;AAkBO,SAAS,wCACd,IAAA,EACwB;AACxB,EAAA,MAAM,EAAE,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,cAAA,GAAiB,kBAAiB,GAAI,IAAA;AAClE,EAAA,MAAM,GAAA,GAAM,yBAAA,CAA0B,IAAA,EAAM,KAAA,EAAO,cAAc,CAAA;AAEjE,EAAA,MAAM,IAAA,GAAsB;AAAA,IAC1B,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,YAAY,IAAA,EAAK;AAAA,IAClD,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACjD,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IACpD,EAAE,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IACnD,EAAE,MAAA,EAAQ,iBAAA,EAAmB,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IAChE,EAAE,MAAA,EAAQ,cAAA,EAAgB,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA;AAAM,GAC/D;AAIA,EAAA,OAAO,IAAIC,8BAAA,CAAuB;AAAA,IAChC,SAAA,EAAW,2BAAA;AAAA,IACX,IAAA;AAAA,IACA,IAAA,EAAM,MAAA,CAAO,KAAA,CAAM,CAAC;AAAA,GACrB,CAAA;AACH;AASO,SAAS,uBAAA,CACd,SAAA,EACA,IAAA,EACA,IAAA,EACwB;AACxB,EAAA,OAAO,IAAIA,8BAAA,CAAuB;AAAA,IAChC,SAAA;AAAA,IACA,IAAA;AAAA,IACA,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,IAAI;AAAA,GACvB,CAAA;AACH;;;AChGA,SAAS,gBAAgB,QAAA,EAAiD;AACxE,EAAA,IAAI,UAAU,OAAO,QAAA;AACrB,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,MAAM,WAAY,MAAA,CAAmC,MAAA;AACrD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AAQA,eAAsB,YAAA,CACpB,IAAA,GAA4B,EAAC,EACC;AAC9B,EAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,IAAA,CAAK,QAAQ,CAAA;AAC9C,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,QAAA,CAAS,OAAA;AAAA,IACnC,IAAA,CAAK,aAAA,GAAgB,EAAE,aAAA,EAAe,MAAK,GAAI;AAAA,GACjD;AACA,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,MAAM,2DAA2D,CAAA;AAAA,EAC7E;AAEA,EAAA,MAAM,eAAA,GAAkB,CAAmC,EAAA,KACzD,QAAA,CAAS,gBAAgB,EAAE,CAAA;AAE7B,EAAA,MAAM,mBAAA,GAAsB,OAC1B,GAAA,KACiB;AACjB,IAAA,IAAI,QAAA,CAAS,mBAAA,EAAqB,OAAO,QAAA,CAAS,oBAAoB,GAAG,CAAA;AAEzE,IAAA,MAAM,MAAW,EAAC;AAClB,IAAA,KAAA,MAAW,EAAA,IAAM,KAAK,GAAA,CAAI,IAAA,CAAK,MAAM,QAAA,CAAS,eAAA,CAAgB,EAAE,CAAC,CAAA;AACjE,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,EAAE,SAAA,EAAW,eAAA,EAAiB,mBAAA,EAAqB,QAAA,EAAS;AACrE;AASO,SAAS,iBAAA,GAAmD;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,MAAA;AAC1C,EAAA,OAAQ,MAAA,CAAmC,MAAA;AAC7C;;;AC3GA,SAAS,YAAY,GAAA,EAAoC;AACvD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,MAAM,IAAA,GAAO,CAAA,EAAG,IAAA,IAAQ,CAAA,EAAG,eAAA;AAC3B,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG,OAAO,IAAA;AAChC,EAAA,OAAO,MAAA;AACT;AAGA,SAAS,eAAe,GAAA,EAAsB;AAC5C,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,IAAI,OAAO,CAAA,EAAG,kBAAA,KAAuB,QAAA,IAAY,EAAE,kBAAA,EAAoB;AACrE,IAAA,OAAO,CAAA,CAAE,kBAAA;AAAA,EACX;AACA,EAAA,IAAI,OAAO,CAAA,EAAG,OAAA,KAAY,YAAY,CAAA,CAAE,OAAA,SAAgB,CAAA,CAAE,OAAA;AAC1D,EAAA,OAAO,OAAO,GAAG,CAAA;AACnB;AAUA,SAAS,cAAc,IAAA,EAGrB;AACA,EAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAC;AACnB,EAAA,IAAI,gBAAA;AACJ,EAAA,IAAI,eAAA;AACJ,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,MAAM,KAAA,GAAQ,wBAAA,CAAyB,IAAA,CAAK,IAAI,CAAA;AAChD,IAAA,IAAI,KAAA,EAAO,gBAAA,GAAmB,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAA;AAC7C,IAAA,MAAM,MAAA,GAAS,+CAAA,CAAgD,IAAA,CAAK,IAAI,CAAA;AACxE,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,eAAA,GAAkB,MAAA,CAAO,CAAC,CAAA,CAAE,UAAA,CAAW,IAAI,CAAA,GACvC,QAAA,CAAS,MAAA,CAAO,CAAC,GAAG,EAAE,CAAA,GACtB,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,IACtB;AAAA,EACF;AACA,EAAA,OAAO,EAAE,kBAAkB,eAAA,EAAgB;AAC7C;AAQO,SAAS,eAAe,KAAA,EAAiC;AAC9D,EAAA,MAAM,IAAA,GAAO,YAAY,KAAK,CAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,eAAe,KAAK,CAAA;AACjC,EAAA,MAAM,EAAE,gBAAA,EAAkB,eAAA,EAAgB,GAAI,cAAc,IAAI,CAAA;AAEhE,EAAA,MAAM,OAAQ,KAAA,EAA6B,IAAA;AAC3C,EAAA,MAAM,WAAA,GACJ,IAAA,KAAS,sBAAA,IACT,2CAAA,CAA4C,KAAK,IAAI,CAAA;AAEvD,EAAA,MAAM,KAAA,GAAkB,CAAC,IAAI,CAAA;AAC7B,EAAA,IAAI,qBAAqB,MAAA,EAAW;AAClC,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,sBAAA,EAAyB,gBAAgB,CAAA,CAAA,CAAG,CAAA;AAAA,EACzD;AACA,EAAA,IAAI,oBAAoB,MAAA,EAAW;AACjC,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,sBAAA,EAAyB,eAAe,CAAA,CAAA,CAAG,CAAA;AAAA,EACxD;AAEA,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI,eAAA,KAAoB,MAAA,IAAa,gBAAA,KAAqB,MAAA,EAAW;AACnE,IAAA,IAAA,GAAO,mBAAA;AAAA,EACT,WAAW,WAAA,EAAa;AACtB,IAAA,IAAA,GAAO,YAAA;AAAA,EACT,CAAA,MAAA,IAAW,iBAAiB,KAAA,EAAO;AACjC,IAAA,IAAA,GAAO,MAAA;AAAA,EACT,CAAA,MAAO;AACL,IAAA,IAAA,GAAO,SAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,IACvB,IAAA;AAAA,IACA,gBAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACF;AACF;;;AC7EO,SAAS,MAAA,CACd,UAAA,EACA,MAAA,EACA,QAAA,EACA,UAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,MAAA,CAAO,MAAA,EAAQ,UAAU,UAAU,CAAA;AACzD,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,oBAAA,CAAqB,EAAE;AAAA,GAC/C;AACF;AAUO,SAAS,eAAA,CACd,UAAA,EACA,MAAA,EACA,QAAA,EACA,UAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,eAAA,CAAgB,MAAA,EAAQ,UAAU,UAAU,CAAA;AAClE,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,2BAAA,CAA4B,EAAE;AAAA,GACtD;AACF;AAQO,SAAS,YAAA,CACd,YACA,QAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAA;AAC3C,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,wBAAA,CAAyB,EAAE;AAAA,GACnD;AACF;ACrDO,SAAS,iBAAA,CACd,IACA,OAAA,EACa;AACb,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAc,GAAI,OAAA;AACjC,EAAA,MAAM,UAAU,EAAC;AACjB,EAAA,IAAI,kBAAkB,MAAA,EAAW;AAC/B,IAAA,OAAA,CAAQ,OAAA;AAAA,MACNC,4BAAA,CAAqB,mBAAA,CAAoB,EAAE,aAAA,EAAe;AAAA,KAC5D;AAAA,EACF;AACA,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAA,CAAQ,QAAQA,4BAAA,CAAqB,mBAAA,CAAoB,EAAE,KAAA,EAAO,CAAC,CAAA;AAAA,EACrE;AACA,EAAA,EAAA,CAAG,YAAA,CAAa,OAAA,CAAQ,GAAG,OAAO,CAAA;AAClC,EAAA,OAAO,EAAA;AACT;AAWA,eAAsB,mBAAA,CACpB,UAAA,EACA,QAAA,GAAiC,EAAC,EACjB;AACjB,EAAA,MAAMC,KAAAA,GAAO,MAAM,UAAA,CAAW,2BAAA;AAAA,IAC5B,QAAA,CAAS,SAAS,CAAA,GAAI,EAAE,wBAAwB,CAAC,GAAG,QAAQ,CAAA,EAAE,GAAI;AAAA,GACpE;AACA,EAAA,IAAI,CAACA,KAAAA,IAAQA,KAAAA,CAAK,MAAA,KAAW,GAAG,OAAO,CAAA;AACvC,EAAA,OAAOA,KAAAA,CAAK,MAAA,CAAO,CAAC,GAAA,EAAK,CAAA,KAAM,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,iBAAiB,CAAA,EAAG,CAAC,CAAA;AACtE;AAGO,IAAM,IAAA,GAAO;AAAA,EAClB,iBAAA;AAAA,EACA;AACF;;;AC7DO,IAAM,OAAA,GAAU","file":"index.cjs","sourcesContent":["/**\n * Client factory for QoreChain's Solana-compatible JSON-RPC.\n *\n * This is a thin convenience layer over `@solana/web3.js`: it builds (or accepts)\n * a `Connection` bound to the network's SVM RPC endpoint and exposes typed\n * wrappers over the documented Solana-compatible JSON-RPC method set plus\n * transaction build/sign/send helpers.\n *\n * `@solana/web3.js` is a peer dependency; nothing here reimplements it.\n */\n\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  sendAndConfirmTransaction,\n  type AccountInfo,\n  type Commitment,\n  type ConfirmOptions,\n  type GetLatestBlockhashConfig,\n  type Keypair,\n  type RpcResponseAndContext,\n  type SignatureResult,\n  type SimulatedTransactionResponse,\n  type TokenAccountsFilter,\n} from \"@solana/web3.js\";\n\n/** Subset of a qorechain-sdk network's endpoints relevant to the SVM runtime. */\nexport interface SvmEndpoints {\n  /** Solana-compatible JSON-RPC HTTP endpoint. */\n  svmRpc: string;\n}\n\n/** Default testnet SVM RPC endpoint (Solana-compatible JSON-RPC, port 8899). */\nexport const DEFAULT_SVM_RPC_URL = \"http://localhost:8899\";\n\n/** Options for {@link createSvmClient}. */\nexport interface CreateSvmClientOptions {\n  /** Solana-compatible JSON-RPC HTTP URL. Mutually exclusive with `endpoints`. */\n  rpcUrl?: string;\n  /** A qorechain-sdk network endpoints object (uses `svmRpc`). */\n  endpoints?: SvmEndpoints;\n  /** Default commitment level for the connection. */\n  commitment?: Commitment;\n  /**\n   * A preconstructed `Connection`. When provided it is used as-is and `rpcUrl`/\n   * `endpoints`/`commitment` are ignored — primarily for testing.\n   */\n  connection?: Connection;\n}\n\n/** Arguments for building/sending a SOL transfer. */\nexport interface TransferSolArgs {\n  /** Funding/source keypair (signer). */\n  from: Keypair;\n  /** Destination address. */\n  to: PublicKey;\n  /** Amount in lamports. */\n  lamports: number | bigint;\n}\n\n/** A configured QoreChain SVM client bundle. */\nexport interface SvmClient {\n  /** The underlying `@solana/web3.js` `Connection`. */\n  connection: Connection;\n\n  // --- Reads (thin wrappers over the JSON-RPC method set) ---\n  /** Lamport balance for an account. */\n  getBalance(pubkey: PublicKey, commitment?: Commitment): Promise<number>;\n  /** Raw account info, or `null` if the account does not exist. */\n  getAccountInfo(\n    pubkey: PublicKey,\n    commitment?: Commitment,\n  ): Promise<AccountInfo<Buffer> | null>;\n  /** Latest blockhash and last valid block height. */\n  getLatestBlockhash(\n    commitmentOrConfig?: Commitment | GetLatestBlockhashConfig,\n  ): Promise<{ blockhash: string; lastValidBlockHeight: number }>;\n  /** Token accounts owned by `owner`, filtered by mint or program id. */\n  getTokenAccountsByOwner(\n    owner: PublicKey,\n    filter: TokenAccountsFilter,\n    commitment?: Commitment,\n  ): ReturnType<Connection[\"getTokenAccountsByOwner\"]>;\n  /** Confirmed signatures for transactions involving `address`. */\n  getSignaturesForAddress(\n    address: PublicKey,\n    options?: Parameters<Connection[\"getSignaturesForAddress\"]>[1],\n  ): ReturnType<Connection[\"getSignaturesForAddress\"]>;\n  /** Request an airdrop of `lamports` to `pubkey` (testnet/devnet only). */\n  requestAirdrop(pubkey: PublicKey, lamports: number): Promise<string>;\n\n  // --- Transactions ---\n  /** Build (unsigned, no blockhash) a SOL transfer transaction. */\n  buildTransferSol(args: TransferSolArgs): Transaction;\n  /** Build, sign, send, and confirm a SOL transfer. */\n  transferSol(args: TransferSolArgs, options?: ConfirmOptions): Promise<string>;\n  /** Sign, send, and confirm an arbitrary transaction. */\n  sendTransaction(\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string>;\n  /** Simulate a transaction without submitting it. */\n  simulateTransaction(\n    tx: Transaction,\n  ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;\n}\n\nfunction resolveConnection(opts: CreateSvmClientOptions): Connection {\n  if (opts.connection) return opts.connection;\n  const url = opts.rpcUrl ?? opts.endpoints?.svmRpc ?? DEFAULT_SVM_RPC_URL;\n  return new Connection(url, opts.commitment ?? \"confirmed\");\n}\n\n/**\n * Create a QoreChain SVM client bundle.\n *\n * With no options it targets the testnet localhost endpoint\n * (`http://localhost:8899`) at `confirmed` commitment.\n */\nexport function createSvmClient(opts: CreateSvmClientOptions = {}): SvmClient {\n  const connection = resolveConnection(opts);\n\n  const buildTransferSol = (args: TransferSolArgs): Transaction => {\n    const tx = new Transaction();\n    tx.add(\n      SystemProgram.transfer({\n        fromPubkey: args.from.publicKey,\n        toPubkey: args.to,\n        lamports: args.lamports,\n      }),\n    );\n    return tx;\n  };\n\n  const sendTransaction = (\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string> => sendAndConfirmTransaction(connection, tx, signers, options);\n\n  return {\n    connection,\n\n    getBalance: (pubkey, commitment) => connection.getBalance(pubkey, commitment),\n    getAccountInfo: (pubkey, commitment) =>\n      connection.getAccountInfo(pubkey, commitment) as Promise<AccountInfo<Buffer> | null>,\n    getLatestBlockhash: (commitmentOrConfig) =>\n      connection.getLatestBlockhash(commitmentOrConfig),\n    getTokenAccountsByOwner: (owner, filter, commitment) =>\n      connection.getTokenAccountsByOwner(owner, filter, commitment),\n    getSignaturesForAddress: (address, options) =>\n      connection.getSignaturesForAddress(address, options),\n    requestAirdrop: (pubkey, lamports) => connection.requestAirdrop(pubkey, lamports),\n\n    buildTransferSol,\n    transferSol: (args, options) =>\n      sendTransaction(buildTransferSol(args), [args.from], options),\n    sendTransaction,\n    simulateTransaction: (tx): Promise<\n      RpcResponseAndContext<SimulatedTransactionResponse>\n    > =>\n      // The single-arg overload signs/derives blockhash as needed for v1\n      // legacy transactions.\n      (connection.simulateTransaction as (\n        t: Transaction,\n      ) => Promise<RpcResponseAndContext<SimulatedTransactionResponse>>)(tx),\n  };\n}\n\n// Re-export so callers can type their results without a direct dependency on the\n// peer's internal `SignatureResult` import path.\nexport type { SignatureResult };\n","/**\n * Key helpers for QoreChain's Solana-compatible runtime.\n *\n * These are thin wrappers over `@solana/web3.js` so callers don't need a second\n * import path. `@qorechain/sdk`'s `deriveSvmAccount(mnemonic)` provides the\n * 64-byte `secretKey` you can pass straight into {@link svmKeypairFromSecretKey}.\n */\n\nimport { Keypair, PublicKey } from \"@solana/web3.js\";\n\n/**\n * Reconstruct a `@solana/web3.js` `Keypair` from a 64-byte ed25519 secret key\n * (the standard Solana secret-key encoding: 32-byte seed + 32-byte public key).\n *\n * Pair with `@qorechain/sdk`'s `deriveSvmAccount`, which returns this exact\n * 64-byte `secretKey`.\n */\nexport function svmKeypairFromSecretKey(secretKey: Uint8Array): Keypair {\n  if (secretKey.length !== 64) {\n    throw new Error(\n      `svmKeypairFromSecretKey: expected a 64-byte secret key, got ${secretKey.length}`,\n    );\n  }\n  return Keypair.fromSecretKey(secretKey);\n}\n\n/** Return the base58 address for a `Keypair` or a `PublicKey`. */\nexport function svmAddress(key: Keypair | PublicKey): string {\n  const pubkey = key instanceof PublicKey ? key : key.publicKey;\n  return pubkey.toBase58();\n}\n","/**\n * Well-known native program ids for QoreChain's Solana-compatible runtime, plus\n * thin instruction builders for the Memo and SPL-Token programs and the\n * Associated Token Account program.\n *\n * The program ids are the exact canonical ones used by Solana-compatible\n * runtimes, so standard wallets, explorers, and tooling interoperate directly.\n * The SPL-Token / ATA / Memo instructions are built minimally here (by hand)\n * to keep the dependency surface to a single peer — `@solana/web3.js` — with no\n * `@solana/spl-token` requirement.\n */\n\nimport { PublicKey, TransactionInstruction, type AccountMeta } from \"@solana/web3.js\";\n\n/** System program (account creation, SOL transfers). */\nexport const SYSTEM_PROGRAM_ID = new PublicKey(\"11111111111111111111111111111111\");\n\n/** SPL-Token program. */\nexport const TOKEN_PROGRAM_ID = new PublicKey(\"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\");\n\n/** Associated Token Account program. */\nexport const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(\n  \"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL\",\n);\n\n/** SPL Memo program. */\nexport const MEMO_PROGRAM_ID = new PublicKey(\"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\");\n\n/** Convenience grouping of the well-known program ids. */\nexport const PROGRAM_IDS = {\n  system: SYSTEM_PROGRAM_ID,\n  token: TOKEN_PROGRAM_ID,\n  associatedToken: ASSOCIATED_TOKEN_PROGRAM_ID,\n  memo: MEMO_PROGRAM_ID,\n} as const;\n\n/**\n * Build a Memo program instruction carrying `text` (encoded UTF-8).\n *\n * @param text    Memo contents.\n * @param signers Optional accounts that must sign the memo; each is included as\n *                a read-only signer (the Memo program's convention).\n */\nexport function createMemoInstruction(\n  text: string,\n  signers: PublicKey[] = [],\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId: MEMO_PROGRAM_ID,\n    keys: signers.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n    data: Buffer.from(text, \"utf8\"),\n  });\n}\n\n/** Arguments for {@link createTransferTokenInstruction}. */\nexport interface TransferTokenInstructionArgs {\n  /** Source SPL-Token account. */\n  source: PublicKey;\n  /** Destination SPL-Token account. */\n  destination: PublicKey;\n  /** Owner/authority of the source account (signer). */\n  owner: PublicKey;\n  /** Amount in the token's base units. */\n  amount: bigint;\n  /** Additional multisig signers, if `owner` is a multisig. */\n  multiSigners?: PublicKey[];\n}\n\n/**\n * Build an SPL-Token `Transfer` instruction.\n *\n * Layout: 1 byte instruction discriminator (`3` = Transfer) followed by a\n * little-endian u64 amount.\n */\nexport function createTransferTokenInstruction(\n  args: TransferTokenInstructionArgs,\n): TransactionInstruction {\n  const { source, destination, owner, amount, multiSigners = [] } = args;\n\n  const data = Buffer.alloc(9);\n  data.writeUInt8(3, 0);\n  data.writeBigUInt64LE(amount, 1);\n\n  const keys: AccountMeta[] = [\n    { pubkey: source, isSigner: false, isWritable: true },\n    { pubkey: destination, isSigner: false, isWritable: true },\n    {\n      pubkey: owner,\n      isSigner: multiSigners.length === 0,\n      isWritable: false,\n    },\n    ...multiSigners.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n  ];\n\n  return new TransactionInstruction({ programId: TOKEN_PROGRAM_ID, keys, data });\n}\n\n/**\n * Derive the deterministic Associated Token Account (ATA) address for an owner\n * and mint under the SPL-Token program.\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  tokenProgramId: PublicKey = TOKEN_PROGRAM_ID,\n): PublicKey {\n  const [address] = PublicKey.findProgramAddressSync(\n    [owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()],\n    ASSOCIATED_TOKEN_PROGRAM_ID,\n  );\n  return address;\n}\n\n/** Arguments for {@link createAssociatedTokenAccountInstruction}. */\nexport interface CreateAssociatedTokenAccountInstructionArgs {\n  /** Account funding the rent for the new ATA (signer, writable). */\n  payer: PublicKey;\n  /** Wallet that will own the new ATA. */\n  owner: PublicKey;\n  /** Token mint. */\n  mint: PublicKey;\n  /** SPL-Token program id (defaults to the canonical SPL-Token program). */\n  tokenProgramId?: PublicKey;\n}\n\n/**\n * Build an instruction that creates the Associated Token Account for\n * `(owner, mint)`. The ATA address is derived deterministically.\n */\nexport function createAssociatedTokenAccountInstruction(\n  args: CreateAssociatedTokenAccountInstructionArgs,\n): TransactionInstruction {\n  const { payer, owner, mint, tokenProgramId = TOKEN_PROGRAM_ID } = args;\n  const ata = getAssociatedTokenAddress(mint, owner, tokenProgramId);\n\n  const keys: AccountMeta[] = [\n    { pubkey: payer, isSigner: true, isWritable: true },\n    { pubkey: ata, isSigner: false, isWritable: true },\n    { pubkey: owner, isSigner: false, isWritable: false },\n    { pubkey: mint, isSigner: false, isWritable: false },\n    { pubkey: SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },\n    { pubkey: tokenProgramId, isSigner: false, isWritable: false },\n  ];\n\n  // The ATA \"Create\" instruction takes empty data (the idempotent variant uses\n  // a single 0x01 byte; this is the plain create).\n  return new TransactionInstruction({\n    programId: ASSOCIATED_TOKEN_PROGRAM_ID,\n    keys,\n    data: Buffer.alloc(0),\n  });\n}\n\n/**\n * Generic instruction builder for invoking an arbitrary on-chain program.\n *\n * Use this with {@link createSvmClient}'s `sendTransaction` to call a deployed\n * BPF program. Deploy programs with standard Solana tooling (e.g.\n * `solana program deploy`); this package intentionally does not wrap the loader.\n */\nexport function createInvokeInstruction(\n  programId: PublicKey,\n  keys: AccountMeta[],\n  data: Uint8Array,\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId,\n    keys,\n    data: Buffer.from(data),\n  });\n}\n","/**\n * SVM browser-wallet integration for QoreChain (Phantom and Wallet-Standard).\n *\n * Adapts an injected Solana provider (Phantom's `window.solana` is the baseline)\n * into a shape usable with `@solana/web3.js`, so apps can sign and send via the\n * existing SVM client.\n *\n * ```ts\n * import { getSvmWallet } from \"@qorechain/svm\";\n * import { createSvmClient } from \"@qorechain/svm\";\n *\n * const wallet = await getSvmWallet();\n * const signed = await wallet.signTransaction(tx);\n * // ...then send with createSvmClient(...).sendRawTransaction(...)\n * ```\n */\n\nimport type { PublicKey, Transaction, VersionedTransaction } from \"@solana/web3.js\";\n\n/** A transaction the wallet can sign (legacy or versioned). */\nexport type SvmSignableTransaction = Transaction | VersionedTransaction;\n\n/**\n * The minimal injected Solana-wallet surface used here. Phantom (and most\n * Wallet-Standard providers) implement at least these. Declared structurally so\n * no wallet types package is required.\n */\nexport interface InjectedSvmWallet {\n  /** Phantom marker; present on the Phantom provider. */\n  isPhantom?: boolean;\n  /** Connect and return the account public key. */\n  connect(opts?: { onlyIfTrusted?: boolean }): Promise<{ publicKey: PublicKey }>;\n  /** Disconnect the wallet. */\n  disconnect?(): Promise<void>;\n  /** The connected account public key (populated after `connect`). */\n  publicKey?: PublicKey | null;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions. */\n  signAllTransactions?<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n}\n\n/** Window augmentation for the default injected Solana provider. */\ninterface SolanaWindow {\n  solana?: InjectedSvmWallet;\n}\n\n/** Options for {@link getSvmWallet}. */\nexport interface GetSvmWalletOptions {\n  /** The injected provider to use. Defaults to `window.solana` (Phantom). */\n  provider?: InjectedSvmWallet;\n  /** Pass through to the provider's `connect` (e.g. silent reconnect). */\n  onlyIfTrusted?: boolean;\n}\n\n/**\n * A connected SVM wallet adapted for use with `@solana/web3.js`.\n *\n * `signTransaction` / `signAllTransactions` accept and return web3.js\n * `Transaction` / `VersionedTransaction` objects, so they drop into the existing\n * SVM client's send path.\n */\nexport interface SvmWalletConnection {\n  /** The connected account public key. */\n  publicKey: PublicKey;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions (falls back to sequential signing). */\n  signAllTransactions<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n  /** The underlying injected provider. */\n  provider: InjectedSvmWallet;\n}\n\n/** Resolve the injected Solana provider from options or `window`, or throw. */\nfunction resolveProvider(provider?: InjectedSvmWallet): InjectedSvmWallet {\n  if (provider) return provider;\n  if (typeof window === \"undefined\") {\n    throw new Error(\n      \"getSvmWallet: no browser `window` available. Run in a browser, or pass `provider` explicitly.\",\n    );\n  }\n  const injected = (window as unknown as SolanaWindow).solana;\n  if (!injected) {\n    throw new Error(\n      \"getSvmWallet: no injected Solana provider found (window.solana). Install Phantom, or pass `provider`.\",\n    );\n  }\n  return injected;\n}\n\n/**\n * Connect to an injected Solana wallet (Phantom by default) and return an\n * adapter usable with `@solana/web3.js`.\n *\n * Browser-only: throws a clear error if no `window` or no injected provider.\n */\nexport async function getSvmWallet(\n  opts: GetSvmWalletOptions = {},\n): Promise<SvmWalletConnection> {\n  const provider = resolveProvider(opts.provider);\n  const { publicKey } = await provider.connect(\n    opts.onlyIfTrusted ? { onlyIfTrusted: true } : undefined,\n  );\n  if (!publicKey) {\n    throw new Error(\"getSvmWallet: wallet connected but returned no public key\");\n  }\n\n  const signTransaction = <T extends SvmSignableTransaction>(tx: T): Promise<T> =>\n    provider.signTransaction(tx);\n\n  const signAllTransactions = async <T extends SvmSignableTransaction>(\n    txs: T[],\n  ): Promise<T[]> => {\n    if (provider.signAllTransactions) return provider.signAllTransactions(txs);\n    // Fall back to signing sequentially for providers without batch support.\n    const out: T[] = [];\n    for (const tx of txs) out.push(await provider.signTransaction(tx));\n    return out;\n  };\n\n  return { publicKey, signTransaction, signAllTransactions, provider };\n}\n\n/**\n * Detect a Wallet-Standard / Phantom Solana provider on `window`.\n *\n * Returns the injected provider if present, else `undefined`. Phantom's\n * `window.solana` is the baseline; this is a light convenience for apps that\n * want to feature-detect before prompting a connection.\n */\nexport function detectSvmProvider(): InjectedSvmWallet | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  return (window as unknown as SolanaWindow).solana;\n}\n","/**\n * Human-readable decoding of SVM (Solana-compatible) transaction errors.\n *\n * `@solana/web3.js` throws a `SendTransactionError` (and related shapes) whose\n * useful detail — the failing instruction index, a program's custom error code,\n * and the program logs — is spread across several fields that differ slightly\n * between library versions. {@link decodeSvmError} reads those fields\n * structurally (so it works across versions) and produces a flat summary with\n * the program logs and, where present, the failing instruction index.\n */\n\n/** A decoded SVM error. */\nexport interface DecodedSvmError {\n  /** A readable summary message. */\n  message: string;\n  /** A short, stable kind discriminator. */\n  kind: \"instruction_error\" | \"simulation\" | \"send\" | \"unknown\";\n  /** Zero-based index of the failing instruction, when determinable. */\n  instructionIndex?: number;\n  /** A program's custom error code, when present in the logs. */\n  customErrorCode?: number;\n  /** The program logs, when available. */\n  logs?: string[];\n}\n\n/** Read the program logs from the various shapes web3.js uses. */\nfunction extractLogs(err: unknown): string[] | undefined {\n  const e = err as { logs?: unknown; transactionLogs?: unknown };\n  const logs = e?.logs ?? e?.transactionLogs;\n  if (Array.isArray(logs)) return logs as string[];\n  return undefined;\n}\n\n/** Read a base message from the various shapes web3.js uses. */\nfunction extractMessage(err: unknown): string {\n  const e = err as { transactionMessage?: unknown; message?: unknown };\n  if (typeof e?.transactionMessage === \"string\" && e.transactionMessage) {\n    return e.transactionMessage;\n  }\n  if (typeof e?.message === \"string\" && e.message) return e.message;\n  return String(err);\n}\n\n/**\n * Parse the failing instruction index and a custom program error code from the\n * program logs, if either is present.\n *\n * Logs commonly contain a line like:\n *   \"Program <id> failed: custom program error: 0x1\"\n * and the instruction index can appear as \"Error processing Instruction 2:\".\n */\nfunction parseFromLogs(logs: string[] | undefined): {\n  instructionIndex?: number;\n  customErrorCode?: number;\n} {\n  if (!logs) return {};\n  let instructionIndex: number | undefined;\n  let customErrorCode: number | undefined;\n  for (const line of logs) {\n    const instr = /instruction\\s+#?(\\d+)/i.exec(line);\n    if (instr) instructionIndex = Number(instr[1]);\n    const custom = /custom program error:\\s*(0x[0-9a-fA-F]+|\\d+)/i.exec(line);\n    if (custom) {\n      customErrorCode = custom[1].startsWith(\"0x\")\n        ? parseInt(custom[1], 16)\n        : Number(custom[1]);\n    }\n  }\n  return { instructionIndex, customErrorCode };\n}\n\n/**\n * Decode an SVM error thrown by `@solana/web3.js` into a readable, structured\n * form.\n *\n * @param error - The thrown error (a `SendTransactionError` or any value).\n */\nexport function decodeSvmError(error: unknown): DecodedSvmError {\n  const logs = extractLogs(error);\n  const base = extractMessage(error);\n  const { instructionIndex, customErrorCode } = parseFromLogs(logs);\n\n  const name = (error as { name?: string })?.name;\n  const isSendError =\n    name === \"SendTransactionError\" ||\n    /simulation failed|transaction simulation/i.test(base);\n\n  const parts: string[] = [base];\n  if (instructionIndex !== undefined) {\n    parts.push(`(failing instruction #${instructionIndex})`);\n  }\n  if (customErrorCode !== undefined) {\n    parts.push(`(custom program error ${customErrorCode})`);\n  }\n\n  let kind: DecodedSvmError[\"kind\"];\n  if (customErrorCode !== undefined || instructionIndex !== undefined) {\n    kind = \"instruction_error\";\n  } else if (isSendError) {\n    kind = \"simulation\";\n  } else if (error instanceof Error) {\n    kind = \"send\";\n  } else {\n    kind = \"unknown\";\n  }\n\n  return {\n    message: parts.join(\" \"),\n    kind,\n    instructionIndex,\n    customErrorCode,\n    logs,\n  };\n}\n","/**\n * Real-time SVM subscriptions over the `@solana/web3.js` `Connection`.\n *\n * The `Connection` owns the websocket and its lifecycle; these helpers are thin\n * wrappers that register a listener and return both the numeric subscription id\n * and an `off()` function that removes it via the matching\n * `remove*Listener` call. This keeps callers from having to remember which\n * removal method pairs with which subscription.\n */\n\nimport type {\n  AccountChangeCallback,\n  Commitment,\n  Connection,\n  LogsCallback,\n  LogsFilter,\n  PublicKey,\n  SlotChangeCallback,\n} from \"@solana/web3.js\";\n\n/** A registered subscription: its id and a function to remove it. */\nexport interface SvmSubscription {\n  /** The numeric subscription id returned by `@solana/web3.js`. */\n  id: number;\n  /** Remove the listener (idempotent best-effort). */\n  off(): Promise<void>;\n}\n\n/**\n * Subscribe to transaction logs matching `filter`.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param filter - A `LogsFilter` (`\"all\"`, `\"allWithVotes\"`, or a `PublicKey`).\n * @param callback - Invoked with each matching logs notification.\n * @param commitment - Optional commitment level.\n */\nexport function onLogs(\n  connection: Connection,\n  filter: LogsFilter,\n  callback: LogsCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onLogs(filter, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeOnLogsListener(id),\n  };\n}\n\n/**\n * Subscribe to changes of an account's data.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param pubkey - The account to watch.\n * @param callback - Invoked with each account change.\n * @param commitment - Optional commitment level.\n */\nexport function onAccountChange(\n  connection: Connection,\n  pubkey: PublicKey,\n  callback: AccountChangeCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onAccountChange(pubkey, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeAccountChangeListener(id),\n  };\n}\n\n/**\n * Subscribe to slot changes (new slots as they are processed).\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param callback - Invoked with each slot change.\n */\nexport function onSlotChange(\n  connection: Connection,\n  callback: SlotChangeCallback,\n): SvmSubscription {\n  const id = connection.onSlotChange(callback);\n  return {\n    id,\n    off: () => connection.removeSlotChangeListener(id),\n  };\n}\n","/**\n * Compute-budget and priority-fee conveniences over `@solana/web3.js`.\n *\n * {@link withComputeBudget} prepends `ComputeBudgetProgram` instructions to a\n * legacy `Transaction` so it requests a compute-unit limit and pays a per-CU\n * priority price; {@link estimatePriorityFee} reads recent prioritization fees\n * from the RPC to suggest a `microLamports` price.\n */\n\nimport {\n  ComputeBudgetProgram,\n  type Connection,\n  type PublicKey,\n  type Transaction,\n} from \"@solana/web3.js\";\n\n/** Compute-budget options for {@link withComputeBudget}. */\nexport interface ComputeBudgetOptions {\n  /** Compute-unit limit to request (`setComputeUnitLimit`). */\n  units?: number;\n  /** Per-compute-unit price in micro-lamports (`setComputeUnitPrice`). */\n  microLamports?: number | bigint;\n}\n\n/**\n * Prepend `ComputeBudgetProgram` instructions to `tx` (mutating it in place and\n * returning it). A unit-limit instruction is added when `units` is given, and a\n * unit-price instruction when `microLamports` is given; both are inserted at the\n * front of the instruction list, as required by the runtime.\n *\n * @returns The same `tx`, for chaining.\n */\nexport function withComputeBudget(\n  tx: Transaction,\n  options: ComputeBudgetOptions,\n): Transaction {\n  const { units, microLamports } = options;\n  const prepend = [];\n  if (microLamports !== undefined) {\n    prepend.unshift(\n      ComputeBudgetProgram.setComputeUnitPrice({ microLamports }),\n    );\n  }\n  if (units !== undefined) {\n    prepend.unshift(ComputeBudgetProgram.setComputeUnitLimit({ units }));\n  }\n  tx.instructions.unshift(...prepend);\n  return tx;\n}\n\n/**\n * Estimate a priority fee (`microLamports` per CU) from the RPC's\n * `getRecentPrioritizationFees`. Returns the maximum recently observed fee,\n * which is a conservative choice for landing a transaction quickly. Returns `0`\n * when the RPC reports no recent fees.\n *\n * @param connection - SVM RPC connection.\n * @param accounts   - Optional accounts the tx will lock, scoping the query.\n */\nexport async function estimatePriorityFee(\n  connection: Connection,\n  accounts: readonly PublicKey[] = [],\n): Promise<number> {\n  const fees = await connection.getRecentPrioritizationFees(\n    accounts.length > 0 ? { lockedWritableAccounts: [...accounts] } : undefined,\n  );\n  if (!fees || fees.length === 0) return 0;\n  return fees.reduce((max, f) => Math.max(max, f.prioritizationFee), 0);\n}\n\n/** Namespaced compute-budget / fee helpers. */\nexport const fees = {\n  withComputeBudget,\n  estimatePriorityFee,\n} as const;\n","/**\n * `@qorechain/svm` — a thin, type-safe adapter over\n * [`@solana/web3.js`](https://solana-labs.github.io/solana-web3.js/) for\n * QoreChain's Solana-compatible JSON-RPC.\n *\n * It does not reimplement an SVM client; `@solana/web3.js` is a peer dependency.\n * This package adds QoreChain-specific conveniences: a client factory targeting\n * the SVM RPC endpoint, key helpers, typed read wrappers, SOL transfer\n * build/sign/send, and minimal native-program instruction builders (Memo,\n * SPL-Token, Associated Token Account) plus a generic program-invoke builder.\n */\n\n/** Package version. */\nexport const VERSION = \"0.3.0\";\n\nexport {\n  createSvmClient,\n  DEFAULT_SVM_RPC_URL,\n  type CreateSvmClientOptions,\n  type SvmClient,\n  type SvmEndpoints,\n  type TransferSolArgs,\n  type SignatureResult,\n} from \"./client\";\n\nexport { svmKeypairFromSecretKey, svmAddress } from \"./keys\";\n\nexport {\n  PROGRAM_IDS,\n  SYSTEM_PROGRAM_ID,\n  TOKEN_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n  MEMO_PROGRAM_ID,\n  createMemoInstruction,\n  createTransferTokenInstruction,\n  createAssociatedTokenAccountInstruction,\n  getAssociatedTokenAddress,\n  createInvokeInstruction,\n  type TransferTokenInstructionArgs,\n  type CreateAssociatedTokenAccountInstructionArgs,\n} from \"./programs\";\n\nexport {\n  getSvmWallet,\n  detectSvmProvider,\n  type InjectedSvmWallet,\n  type GetSvmWalletOptions,\n  type SvmWalletConnection,\n  type SvmSignableTransaction,\n} from \"./wallet\";\n\nexport { decodeSvmError, type DecodedSvmError } from \"./errors\";\n\nexport {\n  onLogs,\n  onAccountChange,\n  onSlotChange,\n  type SvmSubscription,\n} from \"./subscribe\";\n\nexport {\n  fees,\n  withComputeBudget,\n  estimatePriorityFee,\n  type ComputeBudgetOptions,\n} from \"./fees\";\n"]}
+{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/programs.ts","../src/wallet.ts","../src/errors.ts","../src/subscribe.ts","../src/fees.ts","../src/index.ts"],"names":["Connection","Transaction","SystemProgram","sendAndConfirmTransaction","Keypair","PublicKey","TransactionInstruction","ComputeBudgetProgram","fees"],"mappings":";;;;;AAmCO,IAAM,mBAAA,GAAsB;AA2EnC,SAAS,kBAAkB,IAAA,EAA0C;AACnE,EAAA,IAAI,IAAA,CAAK,UAAA,EAAY,OAAO,IAAA,CAAK,UAAA;AACjC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,MAAA,IAAU,IAAA,CAAK,WAAW,MAAA,IAAU,mBAAA;AACrD,EAAA,OAAO,IAAIA,kBAAA,CAAW,GAAA,EAAK,IAAA,CAAK,cAAc,WAAW,CAAA;AAC3D;AAQO,SAAS,eAAA,CAAgB,IAAA,GAA+B,EAAC,EAAc;AAC5E,EAAA,MAAM,UAAA,GAAa,kBAAkB,IAAI,CAAA;AAEzC,EAAA,MAAM,gBAAA,GAAmB,CAAC,IAAA,KAAuC;AAC/D,IAAA,MAAM,EAAA,GAAK,IAAIC,mBAAA,EAAY;AAC3B,IAAA,EAAA,CAAG,GAAA;AAAA,MACDC,sBAAc,QAAA,CAAS;AAAA,QACrB,UAAA,EAAY,KAAK,IAAA,CAAK,SAAA;AAAA,QACtB,UAAU,IAAA,CAAK,EAAA;AAAA,QACf,UAAU,IAAA,CAAK;AAAA,OAChB;AAAA,KACH;AACA,IAAA,OAAO,EAAA;AAAA,EACT,CAAA;AAEA,EAAA,MAAM,eAAA,GAAkB,CACtB,EAAA,EACA,OAAA,EACA,YACoBC,iCAAA,CAA0B,UAAA,EAAY,EAAA,EAAI,OAAA,EAAS,OAAO,CAAA;AAEhF,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IAEA,YAAY,CAAC,MAAA,EAAQ,eAAe,UAAA,CAAW,UAAA,CAAW,QAAQ,UAAU,CAAA;AAAA,IAC5E,gBAAgB,CAAC,MAAA,EAAQ,eACvB,UAAA,CAAW,cAAA,CAAe,QAAQ,UAAU,CAAA;AAAA,IAC9C,kBAAA,EAAoB,CAAC,kBAAA,KACnB,UAAA,CAAW,mBAAmB,kBAAkB,CAAA;AAAA,IAClD,uBAAA,EAAyB,CAAC,KAAA,EAAO,MAAA,EAAQ,eACvC,UAAA,CAAW,uBAAA,CAAwB,KAAA,EAAO,MAAA,EAAQ,UAAU,CAAA;AAAA,IAC9D,yBAAyB,CAAC,OAAA,EAAS,YACjC,UAAA,CAAW,uBAAA,CAAwB,SAAS,OAAO,CAAA;AAAA,IACrD,gBAAgB,CAAC,MAAA,EAAQ,aAAa,UAAA,CAAW,cAAA,CAAe,QAAQ,QAAQ,CAAA;AAAA,IAEhF,gBAAA;AAAA,IACA,WAAA,EAAa,CAAC,IAAA,EAAM,OAAA,KAClB,eAAA,CAAgB,gBAAA,CAAiB,IAAI,CAAA,EAAG,CAAC,IAAA,CAAK,IAAI,CAAA,EAAG,OAAO,CAAA;AAAA,IAC9D,eAAA;AAAA,IACA,qBAAqB,CAAC,EAAA;AAAA;AAAA;AAAA,MAKnB,UAAA,CAAW,oBAEuD,EAAE;AAAA;AAAA,GACzE;AACF;ACzJO,SAAS,wBAAwB,SAAA,EAAgC;AACtE,EAAA,IAAI,SAAA,CAAU,WAAW,EAAA,EAAI;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,4DAAA,EAA+D,UAAU,MAAM,CAAA;AAAA,KACjF;AAAA,EACF;AACA,EAAA,OAAOC,eAAA,CAAQ,cAAc,SAAS,CAAA;AACxC;AAGO,SAAS,WAAW,GAAA,EAAkC;AAC3D,EAAA,MAAM,MAAA,GAAS,GAAA,YAAeC,iBAAAA,GAAY,GAAA,GAAM,GAAA,CAAI,SAAA;AACpD,EAAA,OAAO,OAAO,QAAA,EAAS;AACzB;ACfO,IAAM,iBAAA,GAAoB,IAAIA,iBAAAA,CAAU,kCAAkC;AAG1E,IAAM,gBAAA,GAAmB,IAAIA,iBAAAA,CAAU,6CAA6C;AAGpF,IAAM,8BAA8B,IAAIA,iBAAAA;AAAA,EAC7C;AACF;AAGO,IAAM,eAAA,GAAkB,IAAIA,iBAAAA,CAAU,6CAA6C;AAGnF,IAAM,WAAA,GAAc;AAAA,EACzB,MAAA,EAAQ,iBAAA;AAAA,EACR,KAAA,EAAO,gBAAA;AAAA,EACP,eAAA,EAAiB,2BAAA;AAAA,EACjB,IAAA,EAAM;AACR;AASO,SAAS,qBAAA,CACd,IAAA,EACA,OAAA,GAAuB,EAAC,EACA;AACxB,EAAA,OAAO,IAAIC,8BAAA,CAAuB;AAAA,IAChC,SAAA,EAAW,eAAA;AAAA,IACX,IAAA,EAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,MAAA,EAAQ,QAAA,EAAU,IAAA,EAAM,UAAA,EAAY,KAAA,EAAM,CAAE,CAAA;AAAA,IAC7E,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,IAAA,EAAM,MAAM;AAAA,GAC/B,CAAA;AACH;AAsBO,SAAS,+BACd,IAAA,EACwB;AACxB,EAAA,MAAM,EAAE,QAAQ,WAAA,EAAa,KAAA,EAAO,QAAQ,YAAA,GAAe,IAAG,GAAI,IAAA;AAElE,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA;AAC3B,EAAA,IAAA,CAAK,UAAA,CAAW,GAAG,CAAC,CAAA;AACpB,EAAA,IAAA,CAAK,gBAAA,CAAiB,QAAQ,CAAC,CAAA;AAE/B,EAAA,MAAM,IAAA,GAAsB;AAAA,IAC1B,EAAE,MAAA,EAAQ,MAAA,EAAQ,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACpD,EAAE,MAAA,EAAQ,WAAA,EAAa,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACzD;AAAA,MACE,MAAA,EAAQ,KAAA;AAAA,MACR,QAAA,EAAU,aAAa,MAAA,KAAW,CAAA;AAAA,MAClC,UAAA,EAAY;AAAA,KACd;AAAA,IACA,GAAG,YAAA,CAAa,GAAA,CAAI,CAAC,MAAA,MAAY,EAAE,MAAA,EAAQ,QAAA,EAAU,IAAA,EAAM,UAAA,EAAY,KAAA,EAAM,CAAE;AAAA,GACjF;AAEA,EAAA,OAAO,IAAIA,8BAAA,CAAuB,EAAE,WAAW,gBAAA,EAAkB,IAAA,EAAM,MAAM,CAAA;AAC/E;AAMO,SAAS,yBAAA,CACd,IAAA,EACA,KAAA,EACA,cAAA,GAA4B,gBAAA,EACjB;AACX,EAAA,MAAM,CAAC,OAAO,CAAA,GAAID,iBAAAA,CAAU,sBAAA;AAAA,IAC1B,CAAC,MAAM,QAAA,EAAS,EAAG,eAAe,QAAA,EAAS,EAAG,IAAA,CAAK,QAAA,EAAU,CAAA;AAAA,IAC7D;AAAA,GACF;AACA,EAAA,OAAO,OAAA;AACT;AAkBO,SAAS,wCACd,IAAA,EACwB;AACxB,EAAA,MAAM,EAAE,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,cAAA,GAAiB,kBAAiB,GAAI,IAAA;AAClE,EAAA,MAAM,GAAA,GAAM,yBAAA,CAA0B,IAAA,EAAM,KAAA,EAAO,cAAc,CAAA;AAEjE,EAAA,MAAM,IAAA,GAAsB;AAAA,IAC1B,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,IAAA,EAAM,YAAY,IAAA,EAAK;AAAA,IAClD,EAAE,MAAA,EAAQ,GAAA,EAAK,QAAA,EAAU,KAAA,EAAO,YAAY,IAAA,EAAK;AAAA,IACjD,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IACpD,EAAE,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IACnD,EAAE,MAAA,EAAQ,iBAAA,EAAmB,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA,EAAM;AAAA,IAChE,EAAE,MAAA,EAAQ,cAAA,EAAgB,QAAA,EAAU,KAAA,EAAO,YAAY,KAAA;AAAM,GAC/D;AAIA,EAAA,OAAO,IAAIC,8BAAA,CAAuB;AAAA,IAChC,SAAA,EAAW,2BAAA;AAAA,IACX,IAAA;AAAA,IACA,IAAA,EAAM,MAAA,CAAO,KAAA,CAAM,CAAC;AAAA,GACrB,CAAA;AACH;AASO,SAAS,uBAAA,CACd,SAAA,EACA,IAAA,EACA,IAAA,EACwB;AACxB,EAAA,OAAO,IAAIA,8BAAA,CAAuB;AAAA,IAChC,SAAA;AAAA,IACA,IAAA;AAAA,IACA,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,IAAI;AAAA,GACvB,CAAA;AACH;;;AChGA,SAAS,gBAAgB,QAAA,EAAiD;AACxE,EAAA,IAAI,UAAU,OAAO,QAAA;AACrB,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,MAAM,WAAY,MAAA,CAAmC,MAAA;AACrD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AAQA,eAAsB,YAAA,CACpB,IAAA,GAA4B,EAAC,EACC;AAC9B,EAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,IAAA,CAAK,QAAQ,CAAA;AAC9C,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,QAAA,CAAS,OAAA;AAAA,IACnC,IAAA,CAAK,aAAA,GAAgB,EAAE,aAAA,EAAe,MAAK,GAAI;AAAA,GACjD;AACA,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,MAAM,2DAA2D,CAAA;AAAA,EAC7E;AAEA,EAAA,MAAM,eAAA,GAAkB,CAAmC,EAAA,KACzD,QAAA,CAAS,gBAAgB,EAAE,CAAA;AAE7B,EAAA,MAAM,mBAAA,GAAsB,OAC1B,GAAA,KACiB;AACjB,IAAA,IAAI,QAAA,CAAS,mBAAA,EAAqB,OAAO,QAAA,CAAS,oBAAoB,GAAG,CAAA;AAEzE,IAAA,MAAM,MAAW,EAAC;AAClB,IAAA,KAAA,MAAW,EAAA,IAAM,KAAK,GAAA,CAAI,IAAA,CAAK,MAAM,QAAA,CAAS,eAAA,CAAgB,EAAE,CAAC,CAAA;AACjE,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,EAAE,SAAA,EAAW,eAAA,EAAiB,mBAAA,EAAqB,QAAA,EAAS;AACrE;AASO,SAAS,iBAAA,GAAmD;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,MAAA;AAC1C,EAAA,OAAQ,MAAA,CAAmC,MAAA;AAC7C;;;AC3GA,SAAS,YAAY,GAAA,EAAoC;AACvD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,MAAM,IAAA,GAAO,CAAA,EAAG,IAAA,IAAQ,CAAA,EAAG,eAAA;AAC3B,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,EAAG,OAAO,IAAA;AAChC,EAAA,OAAO,MAAA;AACT;AAGA,SAAS,eAAe,GAAA,EAAsB;AAC5C,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,IAAI,OAAO,CAAA,EAAG,kBAAA,KAAuB,QAAA,IAAY,EAAE,kBAAA,EAAoB;AACrE,IAAA,OAAO,CAAA,CAAE,kBAAA;AAAA,EACX;AACA,EAAA,IAAI,OAAO,CAAA,EAAG,OAAA,KAAY,YAAY,CAAA,CAAE,OAAA,SAAgB,CAAA,CAAE,OAAA;AAC1D,EAAA,OAAO,OAAO,GAAG,CAAA;AACnB;AAUA,SAAS,cAAc,IAAA,EAGrB;AACA,EAAA,IAAI,CAAC,IAAA,EAAM,OAAO,EAAC;AACnB,EAAA,IAAI,gBAAA;AACJ,EAAA,IAAI,eAAA;AACJ,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,MAAM,KAAA,GAAQ,wBAAA,CAAyB,IAAA,CAAK,IAAI,CAAA;AAChD,IAAA,IAAI,KAAA,EAAO,gBAAA,GAAmB,MAAA,CAAO,KAAA,CAAM,CAAC,CAAC,CAAA;AAC7C,IAAA,MAAM,MAAA,GAAS,+CAAA,CAAgD,IAAA,CAAK,IAAI,CAAA;AACxE,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,eAAA,GAAkB,MAAA,CAAO,CAAC,CAAA,CAAE,UAAA,CAAW,IAAI,CAAA,GACvC,QAAA,CAAS,MAAA,CAAO,CAAC,GAAG,EAAE,CAAA,GACtB,MAAA,CAAO,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,IACtB;AAAA,EACF;AACA,EAAA,OAAO,EAAE,kBAAkB,eAAA,EAAgB;AAC7C;AAQO,SAAS,eAAe,KAAA,EAAiC;AAC9D,EAAA,MAAM,IAAA,GAAO,YAAY,KAAK,CAAA;AAC9B,EAAA,MAAM,IAAA,GAAO,eAAe,KAAK,CAAA;AACjC,EAAA,MAAM,EAAE,gBAAA,EAAkB,eAAA,EAAgB,GAAI,cAAc,IAAI,CAAA;AAEhE,EAAA,MAAM,OAAQ,KAAA,EAA6B,IAAA;AAC3C,EAAA,MAAM,WAAA,GACJ,IAAA,KAAS,sBAAA,IACT,2CAAA,CAA4C,KAAK,IAAI,CAAA;AAEvD,EAAA,MAAM,KAAA,GAAkB,CAAC,IAAI,CAAA;AAC7B,EAAA,IAAI,qBAAqB,MAAA,EAAW;AAClC,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,sBAAA,EAAyB,gBAAgB,CAAA,CAAA,CAAG,CAAA;AAAA,EACzD;AACA,EAAA,IAAI,oBAAoB,MAAA,EAAW;AACjC,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,sBAAA,EAAyB,eAAe,CAAA,CAAA,CAAG,CAAA;AAAA,EACxD;AAEA,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI,eAAA,KAAoB,MAAA,IAAa,gBAAA,KAAqB,MAAA,EAAW;AACnE,IAAA,IAAA,GAAO,mBAAA;AAAA,EACT,WAAW,WAAA,EAAa;AACtB,IAAA,IAAA,GAAO,YAAA;AAAA,EACT,CAAA,MAAA,IAAW,iBAAiB,KAAA,EAAO;AACjC,IAAA,IAAA,GAAO,MAAA;AAAA,EACT,CAAA,MAAO;AACL,IAAA,IAAA,GAAO,SAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,IACvB,IAAA;AAAA,IACA,gBAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACF;AACF;;;AC7EO,SAAS,MAAA,CACd,UAAA,EACA,MAAA,EACA,QAAA,EACA,UAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,MAAA,CAAO,MAAA,EAAQ,UAAU,UAAU,CAAA;AACzD,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,oBAAA,CAAqB,EAAE;AAAA,GAC/C;AACF;AAUO,SAAS,eAAA,CACd,UAAA,EACA,MAAA,EACA,QAAA,EACA,UAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,eAAA,CAAgB,MAAA,EAAQ,UAAU,UAAU,CAAA;AAClE,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,2BAAA,CAA4B,EAAE;AAAA,GACtD;AACF;AAQO,SAAS,YAAA,CACd,YACA,QAAA,EACiB;AACjB,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAA;AAC3C,EAAA,OAAO;AAAA,IACL,EAAA;AAAA,IACA,GAAA,EAAK,MAAM,UAAA,CAAW,wBAAA,CAAyB,EAAE;AAAA,GACnD;AACF;ACrDO,SAAS,iBAAA,CACd,IACA,OAAA,EACa;AACb,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAc,GAAI,OAAA;AACjC,EAAA,MAAM,UAAU,EAAC;AACjB,EAAA,IAAI,kBAAkB,MAAA,EAAW;AAC/B,IAAA,OAAA,CAAQ,OAAA;AAAA,MACNC,4BAAA,CAAqB,mBAAA,CAAoB,EAAE,aAAA,EAAe;AAAA,KAC5D;AAAA,EACF;AACA,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,OAAA,CAAQ,QAAQA,4BAAA,CAAqB,mBAAA,CAAoB,EAAE,KAAA,EAAO,CAAC,CAAA;AAAA,EACrE;AACA,EAAA,EAAA,CAAG,YAAA,CAAa,OAAA,CAAQ,GAAG,OAAO,CAAA;AAClC,EAAA,OAAO,EAAA;AACT;AAWA,eAAsB,mBAAA,CACpB,UAAA,EACA,QAAA,GAAiC,EAAC,EACjB;AACjB,EAAA,MAAMC,KAAAA,GAAO,MAAM,UAAA,CAAW,2BAAA;AAAA,IAC5B,QAAA,CAAS,SAAS,CAAA,GAAI,EAAE,wBAAwB,CAAC,GAAG,QAAQ,CAAA,EAAE,GAAI;AAAA,GACpE;AACA,EAAA,IAAI,CAACA,KAAAA,IAAQA,KAAAA,CAAK,MAAA,KAAW,GAAG,OAAO,CAAA;AACvC,EAAA,OAAOA,KAAAA,CAAK,MAAA,CAAO,CAAC,GAAA,EAAK,CAAA,KAAM,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,CAAA,CAAE,iBAAiB,CAAA,EAAG,CAAC,CAAA;AACtE;AAGO,IAAM,IAAA,GAAO;AAAA,EAClB,iBAAA;AAAA,EACA;AACF;;;AC7DO,IAAM,OAAA,GAAU","file":"index.cjs","sourcesContent":["/**\n * Client factory for QoreChain's Solana-compatible JSON-RPC.\n *\n * This is a thin convenience layer over `@solana/web3.js`: it builds (or accepts)\n * a `Connection` bound to the network's SVM RPC endpoint and exposes typed\n * wrappers over the documented Solana-compatible JSON-RPC method set plus\n * transaction build/sign/send helpers.\n *\n * `@solana/web3.js` is a peer dependency; nothing here reimplements it.\n */\n\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  sendAndConfirmTransaction,\n  type AccountInfo,\n  type Commitment,\n  type ConfirmOptions,\n  type GetLatestBlockhashConfig,\n  type Keypair,\n  type RpcResponseAndContext,\n  type SignatureResult,\n  type SimulatedTransactionResponse,\n  type TokenAccountsFilter,\n} from \"@solana/web3.js\";\n\n/** Subset of a qorechain-sdk network's endpoints relevant to the SVM runtime. */\nexport interface SvmEndpoints {\n  /** Solana-compatible JSON-RPC HTTP endpoint. */\n  svmRpc: string;\n}\n\n/** Default testnet SVM RPC endpoint (Solana-compatible JSON-RPC, port 8899). */\nexport const DEFAULT_SVM_RPC_URL = \"http://localhost:8899\";\n\n/** Options for {@link createSvmClient}. */\nexport interface CreateSvmClientOptions {\n  /** Solana-compatible JSON-RPC HTTP URL. Mutually exclusive with `endpoints`. */\n  rpcUrl?: string;\n  /** A qorechain-sdk network endpoints object (uses `svmRpc`). */\n  endpoints?: SvmEndpoints;\n  /** Default commitment level for the connection. */\n  commitment?: Commitment;\n  /**\n   * A preconstructed `Connection`. When provided it is used as-is and `rpcUrl`/\n   * `endpoints`/`commitment` are ignored — primarily for testing.\n   */\n  connection?: Connection;\n}\n\n/** Arguments for building/sending a SOL transfer. */\nexport interface TransferSolArgs {\n  /** Funding/source keypair (signer). */\n  from: Keypair;\n  /** Destination address. */\n  to: PublicKey;\n  /** Amount in lamports. */\n  lamports: number | bigint;\n}\n\n/** A configured QoreChain SVM client bundle. */\nexport interface SvmClient {\n  /** The underlying `@solana/web3.js` `Connection`. */\n  connection: Connection;\n\n  // --- Reads (thin wrappers over the JSON-RPC method set) ---\n  /** Lamport balance for an account. */\n  getBalance(pubkey: PublicKey, commitment?: Commitment): Promise<number>;\n  /** Raw account info, or `null` if the account does not exist. */\n  getAccountInfo(\n    pubkey: PublicKey,\n    commitment?: Commitment,\n  ): Promise<AccountInfo<Buffer> | null>;\n  /** Latest blockhash and last valid block height. */\n  getLatestBlockhash(\n    commitmentOrConfig?: Commitment | GetLatestBlockhashConfig,\n  ): Promise<{ blockhash: string; lastValidBlockHeight: number }>;\n  /** Token accounts owned by `owner`, filtered by mint or program id. */\n  getTokenAccountsByOwner(\n    owner: PublicKey,\n    filter: TokenAccountsFilter,\n    commitment?: Commitment,\n  ): ReturnType<Connection[\"getTokenAccountsByOwner\"]>;\n  /** Confirmed signatures for transactions involving `address`. */\n  getSignaturesForAddress(\n    address: PublicKey,\n    options?: Parameters<Connection[\"getSignaturesForAddress\"]>[1],\n  ): ReturnType<Connection[\"getSignaturesForAddress\"]>;\n  /** Request an airdrop of `lamports` to `pubkey` (testnet/devnet only). */\n  requestAirdrop(pubkey: PublicKey, lamports: number): Promise<string>;\n\n  // --- Transactions ---\n  /** Build (unsigned, no blockhash) a SOL transfer transaction. */\n  buildTransferSol(args: TransferSolArgs): Transaction;\n  /** Build, sign, send, and confirm a SOL transfer. */\n  transferSol(args: TransferSolArgs, options?: ConfirmOptions): Promise<string>;\n  /** Sign, send, and confirm an arbitrary transaction. */\n  sendTransaction(\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string>;\n  /** Simulate a transaction without submitting it. */\n  simulateTransaction(\n    tx: Transaction,\n  ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;\n}\n\nfunction resolveConnection(opts: CreateSvmClientOptions): Connection {\n  if (opts.connection) return opts.connection;\n  const url = opts.rpcUrl ?? opts.endpoints?.svmRpc ?? DEFAULT_SVM_RPC_URL;\n  return new Connection(url, opts.commitment ?? \"confirmed\");\n}\n\n/**\n * Create a QoreChain SVM client bundle.\n *\n * With no options it targets the testnet localhost endpoint\n * (`http://localhost:8899`) at `confirmed` commitment.\n */\nexport function createSvmClient(opts: CreateSvmClientOptions = {}): SvmClient {\n  const connection = resolveConnection(opts);\n\n  const buildTransferSol = (args: TransferSolArgs): Transaction => {\n    const tx = new Transaction();\n    tx.add(\n      SystemProgram.transfer({\n        fromPubkey: args.from.publicKey,\n        toPubkey: args.to,\n        lamports: args.lamports,\n      }),\n    );\n    return tx;\n  };\n\n  const sendTransaction = (\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string> => sendAndConfirmTransaction(connection, tx, signers, options);\n\n  return {\n    connection,\n\n    getBalance: (pubkey, commitment) => connection.getBalance(pubkey, commitment),\n    getAccountInfo: (pubkey, commitment) =>\n      connection.getAccountInfo(pubkey, commitment) as Promise<AccountInfo<Buffer> | null>,\n    getLatestBlockhash: (commitmentOrConfig) =>\n      connection.getLatestBlockhash(commitmentOrConfig),\n    getTokenAccountsByOwner: (owner, filter, commitment) =>\n      connection.getTokenAccountsByOwner(owner, filter, commitment),\n    getSignaturesForAddress: (address, options) =>\n      connection.getSignaturesForAddress(address, options),\n    requestAirdrop: (pubkey, lamports) => connection.requestAirdrop(pubkey, lamports),\n\n    buildTransferSol,\n    transferSol: (args, options) =>\n      sendTransaction(buildTransferSol(args), [args.from], options),\n    sendTransaction,\n    simulateTransaction: (tx): Promise<\n      RpcResponseAndContext<SimulatedTransactionResponse>\n    > =>\n      // The single-arg overload signs/derives blockhash as needed for v1\n      // legacy transactions.\n      (connection.simulateTransaction as (\n        t: Transaction,\n      ) => Promise<RpcResponseAndContext<SimulatedTransactionResponse>>)(tx),\n  };\n}\n\n// Re-export so callers can type their results without a direct dependency on the\n// peer's internal `SignatureResult` import path.\nexport type { SignatureResult };\n","/**\n * Key helpers for QoreChain's Solana-compatible runtime.\n *\n * These are thin wrappers over `@solana/web3.js` so callers don't need a second\n * import path. `@qorechain/sdk`'s `deriveSvmAccount(mnemonic)` provides the\n * 64-byte `secretKey` you can pass straight into {@link svmKeypairFromSecretKey}.\n */\n\nimport { Keypair, PublicKey } from \"@solana/web3.js\";\n\n/**\n * Reconstruct a `@solana/web3.js` `Keypair` from a 64-byte ed25519 secret key\n * (the standard Solana secret-key encoding: 32-byte seed + 32-byte public key).\n *\n * Pair with `@qorechain/sdk`'s `deriveSvmAccount`, which returns this exact\n * 64-byte `secretKey`.\n */\nexport function svmKeypairFromSecretKey(secretKey: Uint8Array): Keypair {\n  if (secretKey.length !== 64) {\n    throw new Error(\n      `svmKeypairFromSecretKey: expected a 64-byte secret key, got ${secretKey.length}`,\n    );\n  }\n  return Keypair.fromSecretKey(secretKey);\n}\n\n/** Return the base58 address for a `Keypair` or a `PublicKey`. */\nexport function svmAddress(key: Keypair | PublicKey): string {\n  const pubkey = key instanceof PublicKey ? key : key.publicKey;\n  return pubkey.toBase58();\n}\n","/**\n * Well-known native program ids for QoreChain's Solana-compatible runtime, plus\n * thin instruction builders for the Memo and SPL-Token programs and the\n * Associated Token Account program.\n *\n * The program ids are the exact canonical ones used by Solana-compatible\n * runtimes, so standard wallets, explorers, and tooling interoperate directly.\n * The SPL-Token / ATA / Memo instructions are built minimally here (by hand)\n * to keep the dependency surface to a single peer — `@solana/web3.js` — with no\n * `@solana/spl-token` requirement.\n */\n\nimport { PublicKey, TransactionInstruction, type AccountMeta } from \"@solana/web3.js\";\n\n/** System program (account creation, SOL transfers). */\nexport const SYSTEM_PROGRAM_ID = new PublicKey(\"11111111111111111111111111111111\");\n\n/** SPL-Token program. */\nexport const TOKEN_PROGRAM_ID = new PublicKey(\"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\");\n\n/** Associated Token Account program. */\nexport const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(\n  \"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL\",\n);\n\n/** SPL Memo program. */\nexport const MEMO_PROGRAM_ID = new PublicKey(\"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\");\n\n/** Convenience grouping of the well-known program ids. */\nexport const PROGRAM_IDS = {\n  system: SYSTEM_PROGRAM_ID,\n  token: TOKEN_PROGRAM_ID,\n  associatedToken: ASSOCIATED_TOKEN_PROGRAM_ID,\n  memo: MEMO_PROGRAM_ID,\n} as const;\n\n/**\n * Build a Memo program instruction carrying `text` (encoded UTF-8).\n *\n * @param text    Memo contents.\n * @param signers Optional accounts that must sign the memo; each is included as\n *                a read-only signer (the Memo program's convention).\n */\nexport function createMemoInstruction(\n  text: string,\n  signers: PublicKey[] = [],\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId: MEMO_PROGRAM_ID,\n    keys: signers.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n    data: Buffer.from(text, \"utf8\"),\n  });\n}\n\n/** Arguments for {@link createTransferTokenInstruction}. */\nexport interface TransferTokenInstructionArgs {\n  /** Source SPL-Token account. */\n  source: PublicKey;\n  /** Destination SPL-Token account. */\n  destination: PublicKey;\n  /** Owner/authority of the source account (signer). */\n  owner: PublicKey;\n  /** Amount in the token's base units. */\n  amount: bigint;\n  /** Additional multisig signers, if `owner` is a multisig. */\n  multiSigners?: PublicKey[];\n}\n\n/**\n * Build an SPL-Token `Transfer` instruction.\n *\n * Layout: 1 byte instruction discriminator (`3` = Transfer) followed by a\n * little-endian u64 amount.\n */\nexport function createTransferTokenInstruction(\n  args: TransferTokenInstructionArgs,\n): TransactionInstruction {\n  const { source, destination, owner, amount, multiSigners = [] } = args;\n\n  const data = Buffer.alloc(9);\n  data.writeUInt8(3, 0);\n  data.writeBigUInt64LE(amount, 1);\n\n  const keys: AccountMeta[] = [\n    { pubkey: source, isSigner: false, isWritable: true },\n    { pubkey: destination, isSigner: false, isWritable: true },\n    {\n      pubkey: owner,\n      isSigner: multiSigners.length === 0,\n      isWritable: false,\n    },\n    ...multiSigners.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n  ];\n\n  return new TransactionInstruction({ programId: TOKEN_PROGRAM_ID, keys, data });\n}\n\n/**\n * Derive the deterministic Associated Token Account (ATA) address for an owner\n * and mint under the SPL-Token program.\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  tokenProgramId: PublicKey = TOKEN_PROGRAM_ID,\n): PublicKey {\n  const [address] = PublicKey.findProgramAddressSync(\n    [owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()],\n    ASSOCIATED_TOKEN_PROGRAM_ID,\n  );\n  return address;\n}\n\n/** Arguments for {@link createAssociatedTokenAccountInstruction}. */\nexport interface CreateAssociatedTokenAccountInstructionArgs {\n  /** Account funding the rent for the new ATA (signer, writable). */\n  payer: PublicKey;\n  /** Wallet that will own the new ATA. */\n  owner: PublicKey;\n  /** Token mint. */\n  mint: PublicKey;\n  /** SPL-Token program id (defaults to the canonical SPL-Token program). */\n  tokenProgramId?: PublicKey;\n}\n\n/**\n * Build an instruction that creates the Associated Token Account for\n * `(owner, mint)`. The ATA address is derived deterministically.\n */\nexport function createAssociatedTokenAccountInstruction(\n  args: CreateAssociatedTokenAccountInstructionArgs,\n): TransactionInstruction {\n  const { payer, owner, mint, tokenProgramId = TOKEN_PROGRAM_ID } = args;\n  const ata = getAssociatedTokenAddress(mint, owner, tokenProgramId);\n\n  const keys: AccountMeta[] = [\n    { pubkey: payer, isSigner: true, isWritable: true },\n    { pubkey: ata, isSigner: false, isWritable: true },\n    { pubkey: owner, isSigner: false, isWritable: false },\n    { pubkey: mint, isSigner: false, isWritable: false },\n    { pubkey: SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },\n    { pubkey: tokenProgramId, isSigner: false, isWritable: false },\n  ];\n\n  // The ATA \"Create\" instruction takes empty data (the idempotent variant uses\n  // a single 0x01 byte; this is the plain create).\n  return new TransactionInstruction({\n    programId: ASSOCIATED_TOKEN_PROGRAM_ID,\n    keys,\n    data: Buffer.alloc(0),\n  });\n}\n\n/**\n * Generic instruction builder for invoking an arbitrary on-chain program.\n *\n * Use this with {@link createSvmClient}'s `sendTransaction` to call a deployed\n * BPF program. Deploy programs with standard Solana tooling (e.g.\n * `solana program deploy`); this package intentionally does not wrap the loader.\n */\nexport function createInvokeInstruction(\n  programId: PublicKey,\n  keys: AccountMeta[],\n  data: Uint8Array,\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId,\n    keys,\n    data: Buffer.from(data),\n  });\n}\n","/**\n * SVM browser-wallet integration for QoreChain (Phantom and Wallet-Standard).\n *\n * Adapts an injected Solana provider (Phantom's `window.solana` is the baseline)\n * into a shape usable with `@solana/web3.js`, so apps can sign and send via the\n * existing SVM client.\n *\n * ```ts\n * import { getSvmWallet } from \"@qorechain/svm\";\n * import { createSvmClient } from \"@qorechain/svm\";\n *\n * const wallet = await getSvmWallet();\n * const signed = await wallet.signTransaction(tx);\n * // ...then send with createSvmClient(...).sendRawTransaction(...)\n * ```\n */\n\nimport type { PublicKey, Transaction, VersionedTransaction } from \"@solana/web3.js\";\n\n/** A transaction the wallet can sign (legacy or versioned). */\nexport type SvmSignableTransaction = Transaction | VersionedTransaction;\n\n/**\n * The minimal injected Solana-wallet surface used here. Phantom (and most\n * Wallet-Standard providers) implement at least these. Declared structurally so\n * no wallet types package is required.\n */\nexport interface InjectedSvmWallet {\n  /** Phantom marker; present on the Phantom provider. */\n  isPhantom?: boolean;\n  /** Connect and return the account public key. */\n  connect(opts?: { onlyIfTrusted?: boolean }): Promise<{ publicKey: PublicKey }>;\n  /** Disconnect the wallet. */\n  disconnect?(): Promise<void>;\n  /** The connected account public key (populated after `connect`). */\n  publicKey?: PublicKey | null;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions. */\n  signAllTransactions?<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n}\n\n/** Window augmentation for the default injected Solana provider. */\ninterface SolanaWindow {\n  solana?: InjectedSvmWallet;\n}\n\n/** Options for {@link getSvmWallet}. */\nexport interface GetSvmWalletOptions {\n  /** The injected provider to use. Defaults to `window.solana` (Phantom). */\n  provider?: InjectedSvmWallet;\n  /** Pass through to the provider's `connect` (e.g. silent reconnect). */\n  onlyIfTrusted?: boolean;\n}\n\n/**\n * A connected SVM wallet adapted for use with `@solana/web3.js`.\n *\n * `signTransaction` / `signAllTransactions` accept and return web3.js\n * `Transaction` / `VersionedTransaction` objects, so they drop into the existing\n * SVM client's send path.\n */\nexport interface SvmWalletConnection {\n  /** The connected account public key. */\n  publicKey: PublicKey;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions (falls back to sequential signing). */\n  signAllTransactions<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n  /** The underlying injected provider. */\n  provider: InjectedSvmWallet;\n}\n\n/** Resolve the injected Solana provider from options or `window`, or throw. */\nfunction resolveProvider(provider?: InjectedSvmWallet): InjectedSvmWallet {\n  if (provider) return provider;\n  if (typeof window === \"undefined\") {\n    throw new Error(\n      \"getSvmWallet: no browser `window` available. Run in a browser, or pass `provider` explicitly.\",\n    );\n  }\n  const injected = (window as unknown as SolanaWindow).solana;\n  if (!injected) {\n    throw new Error(\n      \"getSvmWallet: no injected Solana provider found (window.solana). Install Phantom, or pass `provider`.\",\n    );\n  }\n  return injected;\n}\n\n/**\n * Connect to an injected Solana wallet (Phantom by default) and return an\n * adapter usable with `@solana/web3.js`.\n *\n * Browser-only: throws a clear error if no `window` or no injected provider.\n */\nexport async function getSvmWallet(\n  opts: GetSvmWalletOptions = {},\n): Promise<SvmWalletConnection> {\n  const provider = resolveProvider(opts.provider);\n  const { publicKey } = await provider.connect(\n    opts.onlyIfTrusted ? { onlyIfTrusted: true } : undefined,\n  );\n  if (!publicKey) {\n    throw new Error(\"getSvmWallet: wallet connected but returned no public key\");\n  }\n\n  const signTransaction = <T extends SvmSignableTransaction>(tx: T): Promise<T> =>\n    provider.signTransaction(tx);\n\n  const signAllTransactions = async <T extends SvmSignableTransaction>(\n    txs: T[],\n  ): Promise<T[]> => {\n    if (provider.signAllTransactions) return provider.signAllTransactions(txs);\n    // Fall back to signing sequentially for providers without batch support.\n    const out: T[] = [];\n    for (const tx of txs) out.push(await provider.signTransaction(tx));\n    return out;\n  };\n\n  return { publicKey, signTransaction, signAllTransactions, provider };\n}\n\n/**\n * Detect a Wallet-Standard / Phantom Solana provider on `window`.\n *\n * Returns the injected provider if present, else `undefined`. Phantom's\n * `window.solana` is the baseline; this is a light convenience for apps that\n * want to feature-detect before prompting a connection.\n */\nexport function detectSvmProvider(): InjectedSvmWallet | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  return (window as unknown as SolanaWindow).solana;\n}\n","/**\n * Human-readable decoding of SVM (Solana-compatible) transaction errors.\n *\n * `@solana/web3.js` throws a `SendTransactionError` (and related shapes) whose\n * useful detail — the failing instruction index, a program's custom error code,\n * and the program logs — is spread across several fields that differ slightly\n * between library versions. {@link decodeSvmError} reads those fields\n * structurally (so it works across versions) and produces a flat summary with\n * the program logs and, where present, the failing instruction index.\n */\n\n/** A decoded SVM error. */\nexport interface DecodedSvmError {\n  /** A readable summary message. */\n  message: string;\n  /** A short, stable kind discriminator. */\n  kind: \"instruction_error\" | \"simulation\" | \"send\" | \"unknown\";\n  /** Zero-based index of the failing instruction, when determinable. */\n  instructionIndex?: number;\n  /** A program's custom error code, when present in the logs. */\n  customErrorCode?: number;\n  /** The program logs, when available. */\n  logs?: string[];\n}\n\n/** Read the program logs from the various shapes web3.js uses. */\nfunction extractLogs(err: unknown): string[] | undefined {\n  const e = err as { logs?: unknown; transactionLogs?: unknown };\n  const logs = e?.logs ?? e?.transactionLogs;\n  if (Array.isArray(logs)) return logs as string[];\n  return undefined;\n}\n\n/** Read a base message from the various shapes web3.js uses. */\nfunction extractMessage(err: unknown): string {\n  const e = err as { transactionMessage?: unknown; message?: unknown };\n  if (typeof e?.transactionMessage === \"string\" && e.transactionMessage) {\n    return e.transactionMessage;\n  }\n  if (typeof e?.message === \"string\" && e.message) return e.message;\n  return String(err);\n}\n\n/**\n * Parse the failing instruction index and a custom program error code from the\n * program logs, if either is present.\n *\n * Logs commonly contain a line like:\n *   \"Program <id> failed: custom program error: 0x1\"\n * and the instruction index can appear as \"Error processing Instruction 2:\".\n */\nfunction parseFromLogs(logs: string[] | undefined): {\n  instructionIndex?: number;\n  customErrorCode?: number;\n} {\n  if (!logs) return {};\n  let instructionIndex: number | undefined;\n  let customErrorCode: number | undefined;\n  for (const line of logs) {\n    const instr = /instruction\\s+#?(\\d+)/i.exec(line);\n    if (instr) instructionIndex = Number(instr[1]);\n    const custom = /custom program error:\\s*(0x[0-9a-fA-F]+|\\d+)/i.exec(line);\n    if (custom) {\n      customErrorCode = custom[1].startsWith(\"0x\")\n        ? parseInt(custom[1], 16)\n        : Number(custom[1]);\n    }\n  }\n  return { instructionIndex, customErrorCode };\n}\n\n/**\n * Decode an SVM error thrown by `@solana/web3.js` into a readable, structured\n * form.\n *\n * @param error - The thrown error (a `SendTransactionError` or any value).\n */\nexport function decodeSvmError(error: unknown): DecodedSvmError {\n  const logs = extractLogs(error);\n  const base = extractMessage(error);\n  const { instructionIndex, customErrorCode } = parseFromLogs(logs);\n\n  const name = (error as { name?: string })?.name;\n  const isSendError =\n    name === \"SendTransactionError\" ||\n    /simulation failed|transaction simulation/i.test(base);\n\n  const parts: string[] = [base];\n  if (instructionIndex !== undefined) {\n    parts.push(`(failing instruction #${instructionIndex})`);\n  }\n  if (customErrorCode !== undefined) {\n    parts.push(`(custom program error ${customErrorCode})`);\n  }\n\n  let kind: DecodedSvmError[\"kind\"];\n  if (customErrorCode !== undefined || instructionIndex !== undefined) {\n    kind = \"instruction_error\";\n  } else if (isSendError) {\n    kind = \"simulation\";\n  } else if (error instanceof Error) {\n    kind = \"send\";\n  } else {\n    kind = \"unknown\";\n  }\n\n  return {\n    message: parts.join(\" \"),\n    kind,\n    instructionIndex,\n    customErrorCode,\n    logs,\n  };\n}\n","/**\n * Real-time SVM subscriptions over the `@solana/web3.js` `Connection`.\n *\n * The `Connection` owns the websocket and its lifecycle; these helpers are thin\n * wrappers that register a listener and return both the numeric subscription id\n * and an `off()` function that removes it via the matching\n * `remove*Listener` call. This keeps callers from having to remember which\n * removal method pairs with which subscription.\n */\n\nimport type {\n  AccountChangeCallback,\n  Commitment,\n  Connection,\n  LogsCallback,\n  LogsFilter,\n  PublicKey,\n  SlotChangeCallback,\n} from \"@solana/web3.js\";\n\n/** A registered subscription: its id and a function to remove it. */\nexport interface SvmSubscription {\n  /** The numeric subscription id returned by `@solana/web3.js`. */\n  id: number;\n  /** Remove the listener (idempotent best-effort). */\n  off(): Promise<void>;\n}\n\n/**\n * Subscribe to transaction logs matching `filter`.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param filter - A `LogsFilter` (`\"all\"`, `\"allWithVotes\"`, or a `PublicKey`).\n * @param callback - Invoked with each matching logs notification.\n * @param commitment - Optional commitment level.\n */\nexport function onLogs(\n  connection: Connection,\n  filter: LogsFilter,\n  callback: LogsCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onLogs(filter, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeOnLogsListener(id),\n  };\n}\n\n/**\n * Subscribe to changes of an account's data.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param pubkey - The account to watch.\n * @param callback - Invoked with each account change.\n * @param commitment - Optional commitment level.\n */\nexport function onAccountChange(\n  connection: Connection,\n  pubkey: PublicKey,\n  callback: AccountChangeCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onAccountChange(pubkey, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeAccountChangeListener(id),\n  };\n}\n\n/**\n * Subscribe to slot changes (new slots as they are processed).\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param callback - Invoked with each slot change.\n */\nexport function onSlotChange(\n  connection: Connection,\n  callback: SlotChangeCallback,\n): SvmSubscription {\n  const id = connection.onSlotChange(callback);\n  return {\n    id,\n    off: () => connection.removeSlotChangeListener(id),\n  };\n}\n","/**\n * Compute-budget and priority-fee conveniences over `@solana/web3.js`.\n *\n * {@link withComputeBudget} prepends `ComputeBudgetProgram` instructions to a\n * legacy `Transaction` so it requests a compute-unit limit and pays a per-CU\n * priority price; {@link estimatePriorityFee} reads recent prioritization fees\n * from the RPC to suggest a `microLamports` price.\n */\n\nimport {\n  ComputeBudgetProgram,\n  type Connection,\n  type PublicKey,\n  type Transaction,\n} from \"@solana/web3.js\";\n\n/** Compute-budget options for {@link withComputeBudget}. */\nexport interface ComputeBudgetOptions {\n  /** Compute-unit limit to request (`setComputeUnitLimit`). */\n  units?: number;\n  /** Per-compute-unit price in micro-lamports (`setComputeUnitPrice`). */\n  microLamports?: number | bigint;\n}\n\n/**\n * Prepend `ComputeBudgetProgram` instructions to `tx` (mutating it in place and\n * returning it). A unit-limit instruction is added when `units` is given, and a\n * unit-price instruction when `microLamports` is given; both are inserted at the\n * front of the instruction list, as required by the runtime.\n *\n * @returns The same `tx`, for chaining.\n */\nexport function withComputeBudget(\n  tx: Transaction,\n  options: ComputeBudgetOptions,\n): Transaction {\n  const { units, microLamports } = options;\n  const prepend = [];\n  if (microLamports !== undefined) {\n    prepend.unshift(\n      ComputeBudgetProgram.setComputeUnitPrice({ microLamports }),\n    );\n  }\n  if (units !== undefined) {\n    prepend.unshift(ComputeBudgetProgram.setComputeUnitLimit({ units }));\n  }\n  tx.instructions.unshift(...prepend);\n  return tx;\n}\n\n/**\n * Estimate a priority fee (`microLamports` per CU) from the RPC's\n * `getRecentPrioritizationFees`. Returns the maximum recently observed fee,\n * which is a conservative choice for landing a transaction quickly. Returns `0`\n * when the RPC reports no recent fees.\n *\n * @param connection - SVM RPC connection.\n * @param accounts   - Optional accounts the tx will lock, scoping the query.\n */\nexport async function estimatePriorityFee(\n  connection: Connection,\n  accounts: readonly PublicKey[] = [],\n): Promise<number> {\n  const fees = await connection.getRecentPrioritizationFees(\n    accounts.length > 0 ? { lockedWritableAccounts: [...accounts] } : undefined,\n  );\n  if (!fees || fees.length === 0) return 0;\n  return fees.reduce((max, f) => Math.max(max, f.prioritizationFee), 0);\n}\n\n/** Namespaced compute-budget / fee helpers. */\nexport const fees = {\n  withComputeBudget,\n  estimatePriorityFee,\n} as const;\n","/**\n * `@qorechain/svm` — a thin, type-safe adapter over\n * [`@solana/web3.js`](https://solana-labs.github.io/solana-web3.js/) for\n * QoreChain's Solana-compatible JSON-RPC.\n *\n * It does not reimplement an SVM client; `@solana/web3.js` is a peer dependency.\n * This package adds QoreChain-specific conveniences: a client factory targeting\n * the SVM RPC endpoint, key helpers, typed read wrappers, SOL transfer\n * build/sign/send, and minimal native-program instruction builders (Memo,\n * SPL-Token, Associated Token Account) plus a generic program-invoke builder.\n */\n\n/** Package version. */\nexport const VERSION = \"0.5.0\";\n\nexport {\n  createSvmClient,\n  DEFAULT_SVM_RPC_URL,\n  type CreateSvmClientOptions,\n  type SvmClient,\n  type SvmEndpoints,\n  type TransferSolArgs,\n  type SignatureResult,\n} from \"./client\";\n\nexport { svmKeypairFromSecretKey, svmAddress } from \"./keys\";\n\nexport {\n  PROGRAM_IDS,\n  SYSTEM_PROGRAM_ID,\n  TOKEN_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n  MEMO_PROGRAM_ID,\n  createMemoInstruction,\n  createTransferTokenInstruction,\n  createAssociatedTokenAccountInstruction,\n  getAssociatedTokenAddress,\n  createInvokeInstruction,\n  type TransferTokenInstructionArgs,\n  type CreateAssociatedTokenAccountInstructionArgs,\n} from \"./programs\";\n\nexport {\n  getSvmWallet,\n  detectSvmProvider,\n  type InjectedSvmWallet,\n  type GetSvmWalletOptions,\n  type SvmWalletConnection,\n  type SvmSignableTransaction,\n} from \"./wallet\";\n\nexport { decodeSvmError, type DecodedSvmError } from \"./errors\";\n\nexport {\n  onLogs,\n  onAccountChange,\n  onSlotChange,\n  type SvmSubscription,\n} from \"./subscribe\";\n\nexport {\n  fees,\n  withComputeBudget,\n  estimatePriorityFee,\n  type ComputeBudgetOptions,\n} from \"./fees\";\n"]}

package/dist/index.d.cts

@@ -391,6 +391,6 @@ declare const fees: {
  * SPL-Token, Associated Token Account) plus a generic program-invoke builder.
  */
 /** Package version. */
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.5.0";
 
 export { ASSOCIATED_TOKEN_PROGRAM_ID, type ComputeBudgetOptions, type CreateAssociatedTokenAccountInstructionArgs, type CreateSvmClientOptions, DEFAULT_SVM_RPC_URL, type DecodedSvmError, type GetSvmWalletOptions, type InjectedSvmWallet, MEMO_PROGRAM_ID, PROGRAM_IDS, SYSTEM_PROGRAM_ID, type SvmClient, type SvmEndpoints, type SvmSignableTransaction, type SvmSubscription, type SvmWalletConnection, TOKEN_PROGRAM_ID, type TransferSolArgs, type TransferTokenInstructionArgs, VERSION, createAssociatedTokenAccountInstruction, createInvokeInstruction, createMemoInstruction, createSvmClient, createTransferTokenInstruction, decodeSvmError, detectSvmProvider, estimatePriorityFee, fees, getAssociatedTokenAddress, getSvmWallet, onAccountChange, onLogs, onSlotChange, svmAddress, svmKeypairFromSecretKey, withComputeBudget };

package/dist/index.d.ts

@@ -391,6 +391,6 @@ declare const fees: {
  * SPL-Token, Associated Token Account) plus a generic program-invoke builder.
  */
 /** Package version. */
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.5.0";
 
 export { ASSOCIATED_TOKEN_PROGRAM_ID, type ComputeBudgetOptions, type CreateAssociatedTokenAccountInstructionArgs, type CreateSvmClientOptions, DEFAULT_SVM_RPC_URL, type DecodedSvmError, type GetSvmWalletOptions, type InjectedSvmWallet, MEMO_PROGRAM_ID, PROGRAM_IDS, SYSTEM_PROGRAM_ID, type SvmClient, type SvmEndpoints, type SvmSignableTransaction, type SvmSubscription, type SvmWalletConnection, TOKEN_PROGRAM_ID, type TransferSolArgs, type TransferTokenInstructionArgs, VERSION, createAssociatedTokenAccountInstruction, createInvokeInstruction, createMemoInstruction, createSvmClient, createTransferTokenInstruction, decodeSvmError, detectSvmProvider, estimatePriorityFee, fees, getAssociatedTokenAddress, getSvmWallet, onAccountChange, onLogs, onSlotChange, svmAddress, svmKeypairFromSecretKey, withComputeBudget };

package/dist/index.js

@@ -267,7 +267,7 @@ var fees = {
 };
 
 // src/index.ts
-var VERSION = "0.3.0";
+var VERSION = "0.5.0";
 
 export { ASSOCIATED_TOKEN_PROGRAM_ID, DEFAULT_SVM_RPC_URL, MEMO_PROGRAM_ID, PROGRAM_IDS, SYSTEM_PROGRAM_ID, TOKEN_PROGRAM_ID, VERSION, createAssociatedTokenAccountInstruction, createInvokeInstruction, createMemoInstruction, createSvmClient, createTransferTokenInstruction, decodeSvmError, detectSvmProvider, estimatePriorityFee, fees, getAssociatedTokenAddress, getSvmWallet, onAccountChange, onLogs, onSlotChange, svmAddress, svmKeypairFromSecretKey, withComputeBudget };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/programs.ts","../src/wallet.ts","../src/errors.ts","../src/subscribe.ts","../src/fees.ts","../src/index.ts"],"names":["PublicKey","fees"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Client factory for QoreChain's Solana-compatible JSON-RPC.\n *\n * This is a thin convenience layer over `@solana/web3.js`: it builds (or accepts)\n * a `Connection` bound to the network's SVM RPC endpoint and exposes typed\n * wrappers over the documented Solana-compatible JSON-RPC method set plus\n * transaction build/sign/send helpers.\n *\n * `@solana/web3.js` is a peer dependency; nothing here reimplements it.\n */\n\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  sendAndConfirmTransaction,\n  type AccountInfo,\n  type Commitment,\n  type ConfirmOptions,\n  type GetLatestBlockhashConfig,\n  type Keypair,\n  type RpcResponseAndContext,\n  type SignatureResult,\n  type SimulatedTransactionResponse,\n  type TokenAccountsFilter,\n} from \"@solana/web3.js\";\n\n/** Subset of a qorechain-sdk network's endpoints relevant to the SVM runtime. */\nexport interface SvmEndpoints {\n  /** Solana-compatible JSON-RPC HTTP endpoint. */\n  svmRpc: string;\n}\n\n/** Default testnet SVM RPC endpoint (Solana-compatible JSON-RPC, port 8899). */\nexport const DEFAULT_SVM_RPC_URL = \"http://localhost:8899\";\n\n/** Options for {@link createSvmClient}. */\nexport interface CreateSvmClientOptions {\n  /** Solana-compatible JSON-RPC HTTP URL. Mutually exclusive with `endpoints`. */\n  rpcUrl?: string;\n  /** A qorechain-sdk network endpoints object (uses `svmRpc`). */\n  endpoints?: SvmEndpoints;\n  /** Default commitment level for the connection. */\n  commitment?: Commitment;\n  /**\n   * A preconstructed `Connection`. When provided it is used as-is and `rpcUrl`/\n   * `endpoints`/`commitment` are ignored — primarily for testing.\n   */\n  connection?: Connection;\n}\n\n/** Arguments for building/sending a SOL transfer. */\nexport interface TransferSolArgs {\n  /** Funding/source keypair (signer). */\n  from: Keypair;\n  /** Destination address. */\n  to: PublicKey;\n  /** Amount in lamports. */\n  lamports: number | bigint;\n}\n\n/** A configured QoreChain SVM client bundle. */\nexport interface SvmClient {\n  /** The underlying `@solana/web3.js` `Connection`. */\n  connection: Connection;\n\n  // --- Reads (thin wrappers over the JSON-RPC method set) ---\n  /** Lamport balance for an account. */\n  getBalance(pubkey: PublicKey, commitment?: Commitment): Promise<number>;\n  /** Raw account info, or `null` if the account does not exist. */\n  getAccountInfo(\n    pubkey: PublicKey,\n    commitment?: Commitment,\n  ): Promise<AccountInfo<Buffer> | null>;\n  /** Latest blockhash and last valid block height. */\n  getLatestBlockhash(\n    commitmentOrConfig?: Commitment | GetLatestBlockhashConfig,\n  ): Promise<{ blockhash: string; lastValidBlockHeight: number }>;\n  /** Token accounts owned by `owner`, filtered by mint or program id. */\n  getTokenAccountsByOwner(\n    owner: PublicKey,\n    filter: TokenAccountsFilter,\n    commitment?: Commitment,\n  ): ReturnType<Connection[\"getTokenAccountsByOwner\"]>;\n  /** Confirmed signatures for transactions involving `address`. */\n  getSignaturesForAddress(\n    address: PublicKey,\n    options?: Parameters<Connection[\"getSignaturesForAddress\"]>[1],\n  ): ReturnType<Connection[\"getSignaturesForAddress\"]>;\n  /** Request an airdrop of `lamports` to `pubkey` (testnet/devnet only). */\n  requestAirdrop(pubkey: PublicKey, lamports: number): Promise<string>;\n\n  // --- Transactions ---\n  /** Build (unsigned, no blockhash) a SOL transfer transaction. */\n  buildTransferSol(args: TransferSolArgs): Transaction;\n  /** Build, sign, send, and confirm a SOL transfer. */\n  transferSol(args: TransferSolArgs, options?: ConfirmOptions): Promise<string>;\n  /** Sign, send, and confirm an arbitrary transaction. */\n  sendTransaction(\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string>;\n  /** Simulate a transaction without submitting it. */\n  simulateTransaction(\n    tx: Transaction,\n  ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;\n}\n\nfunction resolveConnection(opts: CreateSvmClientOptions): Connection {\n  if (opts.connection) return opts.connection;\n  const url = opts.rpcUrl ?? opts.endpoints?.svmRpc ?? DEFAULT_SVM_RPC_URL;\n  return new Connection(url, opts.commitment ?? \"confirmed\");\n}\n\n/**\n * Create a QoreChain SVM client bundle.\n *\n * With no options it targets the testnet localhost endpoint\n * (`http://localhost:8899`) at `confirmed` commitment.\n */\nexport function createSvmClient(opts: CreateSvmClientOptions = {}): SvmClient {\n  const connection = resolveConnection(opts);\n\n  const buildTransferSol = (args: TransferSolArgs): Transaction => {\n    const tx = new Transaction();\n    tx.add(\n      SystemProgram.transfer({\n        fromPubkey: args.from.publicKey,\n        toPubkey: args.to,\n        lamports: args.lamports,\n      }),\n    );\n    return tx;\n  };\n\n  const sendTransaction = (\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string> => sendAndConfirmTransaction(connection, tx, signers, options);\n\n  return {\n    connection,\n\n    getBalance: (pubkey, commitment) => connection.getBalance(pubkey, commitment),\n    getAccountInfo: (pubkey, commitment) =>\n      connection.getAccountInfo(pubkey, commitment) as Promise<AccountInfo<Buffer> | null>,\n    getLatestBlockhash: (commitmentOrConfig) =>\n      connection.getLatestBlockhash(commitmentOrConfig),\n    getTokenAccountsByOwner: (owner, filter, commitment) =>\n      connection.getTokenAccountsByOwner(owner, filter, commitment),\n    getSignaturesForAddress: (address, options) =>\n      connection.getSignaturesForAddress(address, options),\n    requestAirdrop: (pubkey, lamports) => connection.requestAirdrop(pubkey, lamports),\n\n    buildTransferSol,\n    transferSol: (args, options) =>\n      sendTransaction(buildTransferSol(args), [args.from], options),\n    sendTransaction,\n    simulateTransaction: (tx): Promise<\n      RpcResponseAndContext<SimulatedTransactionResponse>\n    > =>\n      // The single-arg overload signs/derives blockhash as needed for v1\n      // legacy transactions.\n      (connection.simulateTransaction as (\n        t: Transaction,\n      ) => Promise<RpcResponseAndContext<SimulatedTransactionResponse>>)(tx),\n  };\n}\n\n// Re-export so callers can type their results without a direct dependency on the\n// peer's internal `SignatureResult` import path.\nexport type { SignatureResult };\n","/**\n * Key helpers for QoreChain's Solana-compatible runtime.\n *\n * These are thin wrappers over `@solana/web3.js` so callers don't need a second\n * import path. `@qorechain/sdk`'s `deriveSvmAccount(mnemonic)` provides the\n * 64-byte `secretKey` you can pass straight into {@link svmKeypairFromSecretKey}.\n */\n\nimport { Keypair, PublicKey } from \"@solana/web3.js\";\n\n/**\n * Reconstruct a `@solana/web3.js` `Keypair` from a 64-byte ed25519 secret key\n * (the standard Solana secret-key encoding: 32-byte seed + 32-byte public key).\n *\n * Pair with `@qorechain/sdk`'s `deriveSvmAccount`, which returns this exact\n * 64-byte `secretKey`.\n */\nexport function svmKeypairFromSecretKey(secretKey: Uint8Array): Keypair {\n  if (secretKey.length !== 64) {\n    throw new Error(\n      `svmKeypairFromSecretKey: expected a 64-byte secret key, got ${secretKey.length}`,\n    );\n  }\n  return Keypair.fromSecretKey(secretKey);\n}\n\n/** Return the base58 address for a `Keypair` or a `PublicKey`. */\nexport function svmAddress(key: Keypair | PublicKey): string {\n  const pubkey = key instanceof PublicKey ? key : key.publicKey;\n  return pubkey.toBase58();\n}\n","/**\n * Well-known native program ids for QoreChain's Solana-compatible runtime, plus\n * thin instruction builders for the Memo and SPL-Token programs and the\n * Associated Token Account program.\n *\n * The program ids are the exact canonical ones used by Solana-compatible\n * runtimes, so standard wallets, explorers, and tooling interoperate directly.\n * The SPL-Token / ATA / Memo instructions are built minimally here (by hand)\n * to keep the dependency surface to a single peer — `@solana/web3.js` — with no\n * `@solana/spl-token` requirement.\n */\n\nimport { PublicKey, TransactionInstruction, type AccountMeta } from \"@solana/web3.js\";\n\n/** System program (account creation, SOL transfers). */\nexport const SYSTEM_PROGRAM_ID = new PublicKey(\"11111111111111111111111111111111\");\n\n/** SPL-Token program. */\nexport const TOKEN_PROGRAM_ID = new PublicKey(\"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\");\n\n/** Associated Token Account program. */\nexport const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(\n  \"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL\",\n);\n\n/** SPL Memo program. */\nexport const MEMO_PROGRAM_ID = new PublicKey(\"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\");\n\n/** Convenience grouping of the well-known program ids. */\nexport const PROGRAM_IDS = {\n  system: SYSTEM_PROGRAM_ID,\n  token: TOKEN_PROGRAM_ID,\n  associatedToken: ASSOCIATED_TOKEN_PROGRAM_ID,\n  memo: MEMO_PROGRAM_ID,\n} as const;\n\n/**\n * Build a Memo program instruction carrying `text` (encoded UTF-8).\n *\n * @param text    Memo contents.\n * @param signers Optional accounts that must sign the memo; each is included as\n *                a read-only signer (the Memo program's convention).\n */\nexport function createMemoInstruction(\n  text: string,\n  signers: PublicKey[] = [],\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId: MEMO_PROGRAM_ID,\n    keys: signers.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n    data: Buffer.from(text, \"utf8\"),\n  });\n}\n\n/** Arguments for {@link createTransferTokenInstruction}. */\nexport interface TransferTokenInstructionArgs {\n  /** Source SPL-Token account. */\n  source: PublicKey;\n  /** Destination SPL-Token account. */\n  destination: PublicKey;\n  /** Owner/authority of the source account (signer). */\n  owner: PublicKey;\n  /** Amount in the token's base units. */\n  amount: bigint;\n  /** Additional multisig signers, if `owner` is a multisig. */\n  multiSigners?: PublicKey[];\n}\n\n/**\n * Build an SPL-Token `Transfer` instruction.\n *\n * Layout: 1 byte instruction discriminator (`3` = Transfer) followed by a\n * little-endian u64 amount.\n */\nexport function createTransferTokenInstruction(\n  args: TransferTokenInstructionArgs,\n): TransactionInstruction {\n  const { source, destination, owner, amount, multiSigners = [] } = args;\n\n  const data = Buffer.alloc(9);\n  data.writeUInt8(3, 0);\n  data.writeBigUInt64LE(amount, 1);\n\n  const keys: AccountMeta[] = [\n    { pubkey: source, isSigner: false, isWritable: true },\n    { pubkey: destination, isSigner: false, isWritable: true },\n    {\n      pubkey: owner,\n      isSigner: multiSigners.length === 0,\n      isWritable: false,\n    },\n    ...multiSigners.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n  ];\n\n  return new TransactionInstruction({ programId: TOKEN_PROGRAM_ID, keys, data });\n}\n\n/**\n * Derive the deterministic Associated Token Account (ATA) address for an owner\n * and mint under the SPL-Token program.\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  tokenProgramId: PublicKey = TOKEN_PROGRAM_ID,\n): PublicKey {\n  const [address] = PublicKey.findProgramAddressSync(\n    [owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()],\n    ASSOCIATED_TOKEN_PROGRAM_ID,\n  );\n  return address;\n}\n\n/** Arguments for {@link createAssociatedTokenAccountInstruction}. */\nexport interface CreateAssociatedTokenAccountInstructionArgs {\n  /** Account funding the rent for the new ATA (signer, writable). */\n  payer: PublicKey;\n  /** Wallet that will own the new ATA. */\n  owner: PublicKey;\n  /** Token mint. */\n  mint: PublicKey;\n  /** SPL-Token program id (defaults to the canonical SPL-Token program). */\n  tokenProgramId?: PublicKey;\n}\n\n/**\n * Build an instruction that creates the Associated Token Account for\n * `(owner, mint)`. The ATA address is derived deterministically.\n */\nexport function createAssociatedTokenAccountInstruction(\n  args: CreateAssociatedTokenAccountInstructionArgs,\n): TransactionInstruction {\n  const { payer, owner, mint, tokenProgramId = TOKEN_PROGRAM_ID } = args;\n  const ata = getAssociatedTokenAddress(mint, owner, tokenProgramId);\n\n  const keys: AccountMeta[] = [\n    { pubkey: payer, isSigner: true, isWritable: true },\n    { pubkey: ata, isSigner: false, isWritable: true },\n    { pubkey: owner, isSigner: false, isWritable: false },\n    { pubkey: mint, isSigner: false, isWritable: false },\n    { pubkey: SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },\n    { pubkey: tokenProgramId, isSigner: false, isWritable: false },\n  ];\n\n  // The ATA \"Create\" instruction takes empty data (the idempotent variant uses\n  // a single 0x01 byte; this is the plain create).\n  return new TransactionInstruction({\n    programId: ASSOCIATED_TOKEN_PROGRAM_ID,\n    keys,\n    data: Buffer.alloc(0),\n  });\n}\n\n/**\n * Generic instruction builder for invoking an arbitrary on-chain program.\n *\n * Use this with {@link createSvmClient}'s `sendTransaction` to call a deployed\n * BPF program. Deploy programs with standard Solana tooling (e.g.\n * `solana program deploy`); this package intentionally does not wrap the loader.\n */\nexport function createInvokeInstruction(\n  programId: PublicKey,\n  keys: AccountMeta[],\n  data: Uint8Array,\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId,\n    keys,\n    data: Buffer.from(data),\n  });\n}\n","/**\n * SVM browser-wallet integration for QoreChain (Phantom and Wallet-Standard).\n *\n * Adapts an injected Solana provider (Phantom's `window.solana` is the baseline)\n * into a shape usable with `@solana/web3.js`, so apps can sign and send via the\n * existing SVM client.\n *\n * ```ts\n * import { getSvmWallet } from \"@qorechain/svm\";\n * import { createSvmClient } from \"@qorechain/svm\";\n *\n * const wallet = await getSvmWallet();\n * const signed = await wallet.signTransaction(tx);\n * // ...then send with createSvmClient(...).sendRawTransaction(...)\n * ```\n */\n\nimport type { PublicKey, Transaction, VersionedTransaction } from \"@solana/web3.js\";\n\n/** A transaction the wallet can sign (legacy or versioned). */\nexport type SvmSignableTransaction = Transaction | VersionedTransaction;\n\n/**\n * The minimal injected Solana-wallet surface used here. Phantom (and most\n * Wallet-Standard providers) implement at least these. Declared structurally so\n * no wallet types package is required.\n */\nexport interface InjectedSvmWallet {\n  /** Phantom marker; present on the Phantom provider. */\n  isPhantom?: boolean;\n  /** Connect and return the account public key. */\n  connect(opts?: { onlyIfTrusted?: boolean }): Promise<{ publicKey: PublicKey }>;\n  /** Disconnect the wallet. */\n  disconnect?(): Promise<void>;\n  /** The connected account public key (populated after `connect`). */\n  publicKey?: PublicKey | null;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions. */\n  signAllTransactions?<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n}\n\n/** Window augmentation for the default injected Solana provider. */\ninterface SolanaWindow {\n  solana?: InjectedSvmWallet;\n}\n\n/** Options for {@link getSvmWallet}. */\nexport interface GetSvmWalletOptions {\n  /** The injected provider to use. Defaults to `window.solana` (Phantom). */\n  provider?: InjectedSvmWallet;\n  /** Pass through to the provider's `connect` (e.g. silent reconnect). */\n  onlyIfTrusted?: boolean;\n}\n\n/**\n * A connected SVM wallet adapted for use with `@solana/web3.js`.\n *\n * `signTransaction` / `signAllTransactions` accept and return web3.js\n * `Transaction` / `VersionedTransaction` objects, so they drop into the existing\n * SVM client's send path.\n */\nexport interface SvmWalletConnection {\n  /** The connected account public key. */\n  publicKey: PublicKey;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions (falls back to sequential signing). */\n  signAllTransactions<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n  /** The underlying injected provider. */\n  provider: InjectedSvmWallet;\n}\n\n/** Resolve the injected Solana provider from options or `window`, or throw. */\nfunction resolveProvider(provider?: InjectedSvmWallet): InjectedSvmWallet {\n  if (provider) return provider;\n  if (typeof window === \"undefined\") {\n    throw new Error(\n      \"getSvmWallet: no browser `window` available. Run in a browser, or pass `provider` explicitly.\",\n    );\n  }\n  const injected = (window as unknown as SolanaWindow).solana;\n  if (!injected) {\n    throw new Error(\n      \"getSvmWallet: no injected Solana provider found (window.solana). Install Phantom, or pass `provider`.\",\n    );\n  }\n  return injected;\n}\n\n/**\n * Connect to an injected Solana wallet (Phantom by default) and return an\n * adapter usable with `@solana/web3.js`.\n *\n * Browser-only: throws a clear error if no `window` or no injected provider.\n */\nexport async function getSvmWallet(\n  opts: GetSvmWalletOptions = {},\n): Promise<SvmWalletConnection> {\n  const provider = resolveProvider(opts.provider);\n  const { publicKey } = await provider.connect(\n    opts.onlyIfTrusted ? { onlyIfTrusted: true } : undefined,\n  );\n  if (!publicKey) {\n    throw new Error(\"getSvmWallet: wallet connected but returned no public key\");\n  }\n\n  const signTransaction = <T extends SvmSignableTransaction>(tx: T): Promise<T> =>\n    provider.signTransaction(tx);\n\n  const signAllTransactions = async <T extends SvmSignableTransaction>(\n    txs: T[],\n  ): Promise<T[]> => {\n    if (provider.signAllTransactions) return provider.signAllTransactions(txs);\n    // Fall back to signing sequentially for providers without batch support.\n    const out: T[] = [];\n    for (const tx of txs) out.push(await provider.signTransaction(tx));\n    return out;\n  };\n\n  return { publicKey, signTransaction, signAllTransactions, provider };\n}\n\n/**\n * Detect a Wallet-Standard / Phantom Solana provider on `window`.\n *\n * Returns the injected provider if present, else `undefined`. Phantom's\n * `window.solana` is the baseline; this is a light convenience for apps that\n * want to feature-detect before prompting a connection.\n */\nexport function detectSvmProvider(): InjectedSvmWallet | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  return (window as unknown as SolanaWindow).solana;\n}\n","/**\n * Human-readable decoding of SVM (Solana-compatible) transaction errors.\n *\n * `@solana/web3.js` throws a `SendTransactionError` (and related shapes) whose\n * useful detail — the failing instruction index, a program's custom error code,\n * and the program logs — is spread across several fields that differ slightly\n * between library versions. {@link decodeSvmError} reads those fields\n * structurally (so it works across versions) and produces a flat summary with\n * the program logs and, where present, the failing instruction index.\n */\n\n/** A decoded SVM error. */\nexport interface DecodedSvmError {\n  /** A readable summary message. */\n  message: string;\n  /** A short, stable kind discriminator. */\n  kind: \"instruction_error\" | \"simulation\" | \"send\" | \"unknown\";\n  /** Zero-based index of the failing instruction, when determinable. */\n  instructionIndex?: number;\n  /** A program's custom error code, when present in the logs. */\n  customErrorCode?: number;\n  /** The program logs, when available. */\n  logs?: string[];\n}\n\n/** Read the program logs from the various shapes web3.js uses. */\nfunction extractLogs(err: unknown): string[] | undefined {\n  const e = err as { logs?: unknown; transactionLogs?: unknown };\n  const logs = e?.logs ?? e?.transactionLogs;\n  if (Array.isArray(logs)) return logs as string[];\n  return undefined;\n}\n\n/** Read a base message from the various shapes web3.js uses. */\nfunction extractMessage(err: unknown): string {\n  const e = err as { transactionMessage?: unknown; message?: unknown };\n  if (typeof e?.transactionMessage === \"string\" && e.transactionMessage) {\n    return e.transactionMessage;\n  }\n  if (typeof e?.message === \"string\" && e.message) return e.message;\n  return String(err);\n}\n\n/**\n * Parse the failing instruction index and a custom program error code from the\n * program logs, if either is present.\n *\n * Logs commonly contain a line like:\n *   \"Program <id> failed: custom program error: 0x1\"\n * and the instruction index can appear as \"Error processing Instruction 2:\".\n */\nfunction parseFromLogs(logs: string[] | undefined): {\n  instructionIndex?: number;\n  customErrorCode?: number;\n} {\n  if (!logs) return {};\n  let instructionIndex: number | undefined;\n  let customErrorCode: number | undefined;\n  for (const line of logs) {\n    const instr = /instruction\\s+#?(\\d+)/i.exec(line);\n    if (instr) instructionIndex = Number(instr[1]);\n    const custom = /custom program error:\\s*(0x[0-9a-fA-F]+|\\d+)/i.exec(line);\n    if (custom) {\n      customErrorCode = custom[1].startsWith(\"0x\")\n        ? parseInt(custom[1], 16)\n        : Number(custom[1]);\n    }\n  }\n  return { instructionIndex, customErrorCode };\n}\n\n/**\n * Decode an SVM error thrown by `@solana/web3.js` into a readable, structured\n * form.\n *\n * @param error - The thrown error (a `SendTransactionError` or any value).\n */\nexport function decodeSvmError(error: unknown): DecodedSvmError {\n  const logs = extractLogs(error);\n  const base = extractMessage(error);\n  const { instructionIndex, customErrorCode } = parseFromLogs(logs);\n\n  const name = (error as { name?: string })?.name;\n  const isSendError =\n    name === \"SendTransactionError\" ||\n    /simulation failed|transaction simulation/i.test(base);\n\n  const parts: string[] = [base];\n  if (instructionIndex !== undefined) {\n    parts.push(`(failing instruction #${instructionIndex})`);\n  }\n  if (customErrorCode !== undefined) {\n    parts.push(`(custom program error ${customErrorCode})`);\n  }\n\n  let kind: DecodedSvmError[\"kind\"];\n  if (customErrorCode !== undefined || instructionIndex !== undefined) {\n    kind = \"instruction_error\";\n  } else if (isSendError) {\n    kind = \"simulation\";\n  } else if (error instanceof Error) {\n    kind = \"send\";\n  } else {\n    kind = \"unknown\";\n  }\n\n  return {\n    message: parts.join(\" \"),\n    kind,\n    instructionIndex,\n    customErrorCode,\n    logs,\n  };\n}\n","/**\n * Real-time SVM subscriptions over the `@solana/web3.js` `Connection`.\n *\n * The `Connection` owns the websocket and its lifecycle; these helpers are thin\n * wrappers that register a listener and return both the numeric subscription id\n * and an `off()` function that removes it via the matching\n * `remove*Listener` call. This keeps callers from having to remember which\n * removal method pairs with which subscription.\n */\n\nimport type {\n  AccountChangeCallback,\n  Commitment,\n  Connection,\n  LogsCallback,\n  LogsFilter,\n  PublicKey,\n  SlotChangeCallback,\n} from \"@solana/web3.js\";\n\n/** A registered subscription: its id and a function to remove it. */\nexport interface SvmSubscription {\n  /** The numeric subscription id returned by `@solana/web3.js`. */\n  id: number;\n  /** Remove the listener (idempotent best-effort). */\n  off(): Promise<void>;\n}\n\n/**\n * Subscribe to transaction logs matching `filter`.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param filter - A `LogsFilter` (`\"all\"`, `\"allWithVotes\"`, or a `PublicKey`).\n * @param callback - Invoked with each matching logs notification.\n * @param commitment - Optional commitment level.\n */\nexport function onLogs(\n  connection: Connection,\n  filter: LogsFilter,\n  callback: LogsCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onLogs(filter, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeOnLogsListener(id),\n  };\n}\n\n/**\n * Subscribe to changes of an account's data.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param pubkey - The account to watch.\n * @param callback - Invoked with each account change.\n * @param commitment - Optional commitment level.\n */\nexport function onAccountChange(\n  connection: Connection,\n  pubkey: PublicKey,\n  callback: AccountChangeCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onAccountChange(pubkey, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeAccountChangeListener(id),\n  };\n}\n\n/**\n * Subscribe to slot changes (new slots as they are processed).\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param callback - Invoked with each slot change.\n */\nexport function onSlotChange(\n  connection: Connection,\n  callback: SlotChangeCallback,\n): SvmSubscription {\n  const id = connection.onSlotChange(callback);\n  return {\n    id,\n    off: () => connection.removeSlotChangeListener(id),\n  };\n}\n","/**\n * Compute-budget and priority-fee conveniences over `@solana/web3.js`.\n *\n * {@link withComputeBudget} prepends `ComputeBudgetProgram` instructions to a\n * legacy `Transaction` so it requests a compute-unit limit and pays a per-CU\n * priority price; {@link estimatePriorityFee} reads recent prioritization fees\n * from the RPC to suggest a `microLamports` price.\n */\n\nimport {\n  ComputeBudgetProgram,\n  type Connection,\n  type PublicKey,\n  type Transaction,\n} from \"@solana/web3.js\";\n\n/** Compute-budget options for {@link withComputeBudget}. */\nexport interface ComputeBudgetOptions {\n  /** Compute-unit limit to request (`setComputeUnitLimit`). */\n  units?: number;\n  /** Per-compute-unit price in micro-lamports (`setComputeUnitPrice`). */\n  microLamports?: number | bigint;\n}\n\n/**\n * Prepend `ComputeBudgetProgram` instructions to `tx` (mutating it in place and\n * returning it). A unit-limit instruction is added when `units` is given, and a\n * unit-price instruction when `microLamports` is given; both are inserted at the\n * front of the instruction list, as required by the runtime.\n *\n * @returns The same `tx`, for chaining.\n */\nexport function withComputeBudget(\n  tx: Transaction,\n  options: ComputeBudgetOptions,\n): Transaction {\n  const { units, microLamports } = options;\n  const prepend = [];\n  if (microLamports !== undefined) {\n    prepend.unshift(\n      ComputeBudgetProgram.setComputeUnitPrice({ microLamports }),\n    );\n  }\n  if (units !== undefined) {\n    prepend.unshift(ComputeBudgetProgram.setComputeUnitLimit({ units }));\n  }\n  tx.instructions.unshift(...prepend);\n  return tx;\n}\n\n/**\n * Estimate a priority fee (`microLamports` per CU) from the RPC's\n * `getRecentPrioritizationFees`. Returns the maximum recently observed fee,\n * which is a conservative choice for landing a transaction quickly. Returns `0`\n * when the RPC reports no recent fees.\n *\n * @param connection - SVM RPC connection.\n * @param accounts   - Optional accounts the tx will lock, scoping the query.\n */\nexport async function estimatePriorityFee(\n  connection: Connection,\n  accounts: readonly PublicKey[] = [],\n): Promise<number> {\n  const fees = await connection.getRecentPrioritizationFees(\n    accounts.length > 0 ? { lockedWritableAccounts: [...accounts] } : undefined,\n  );\n  if (!fees || fees.length === 0) return 0;\n  return fees.reduce((max, f) => Math.max(max, f.prioritizationFee), 0);\n}\n\n/** Namespaced compute-budget / fee helpers. */\nexport const fees = {\n  withComputeBudget,\n  estimatePriorityFee,\n} as const;\n","/**\n * `@qorechain/svm` — a thin, type-safe adapter over\n * [`@solana/web3.js`](https://solana-labs.github.io/solana-web3.js/) for\n * QoreChain's Solana-compatible JSON-RPC.\n *\n * It does not reimplement an SVM client; `@solana/web3.js` is a peer dependency.\n * This package adds QoreChain-specific conveniences: a client factory targeting\n * the SVM RPC endpoint, key helpers, typed read wrappers, SOL transfer\n * build/sign/send, and minimal native-program instruction builders (Memo,\n * SPL-Token, Associated Token Account) plus a generic program-invoke builder.\n */\n\n/** Package version. */\nexport const VERSION = \"0.3.0\";\n\nexport {\n  createSvmClient,\n  DEFAULT_SVM_RPC_URL,\n  type CreateSvmClientOptions,\n  type SvmClient,\n  type SvmEndpoints,\n  type TransferSolArgs,\n  type SignatureResult,\n} from \"./client\";\n\nexport { svmKeypairFromSecretKey, svmAddress } from \"./keys\";\n\nexport {\n  PROGRAM_IDS,\n  SYSTEM_PROGRAM_ID,\n  TOKEN_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n  MEMO_PROGRAM_ID,\n  createMemoInstruction,\n  createTransferTokenInstruction,\n  createAssociatedTokenAccountInstruction,\n  getAssociatedTokenAddress,\n  createInvokeInstruction,\n  type TransferTokenInstructionArgs,\n  type CreateAssociatedTokenAccountInstructionArgs,\n} from \"./programs\";\n\nexport {\n  getSvmWallet,\n  detectSvmProvider,\n  type InjectedSvmWallet,\n  type GetSvmWalletOptions,\n  type SvmWalletConnection,\n  type SvmSignableTransaction,\n} from \"./wallet\";\n\nexport { decodeSvmError, type DecodedSvmError } from \"./errors\";\n\nexport {\n  onLogs,\n  onAccountChange,\n  onSlotChange,\n  type SvmSubscription,\n} from \"./subscribe\";\n\nexport {\n  fees,\n  withComputeBudget,\n  estimatePriorityFee,\n  type ComputeBudgetOptions,\n} from \"./fees\";\n"]}
+{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/programs.ts","../src/wallet.ts","../src/errors.ts","../src/subscribe.ts","../src/fees.ts","../src/index.ts"],"names":["PublicKey","fees"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Client factory for QoreChain's Solana-compatible JSON-RPC.\n *\n * This is a thin convenience layer over `@solana/web3.js`: it builds (or accepts)\n * a `Connection` bound to the network's SVM RPC endpoint and exposes typed\n * wrappers over the documented Solana-compatible JSON-RPC method set plus\n * transaction build/sign/send helpers.\n *\n * `@solana/web3.js` is a peer dependency; nothing here reimplements it.\n */\n\nimport {\n  Connection,\n  PublicKey,\n  SystemProgram,\n  Transaction,\n  sendAndConfirmTransaction,\n  type AccountInfo,\n  type Commitment,\n  type ConfirmOptions,\n  type GetLatestBlockhashConfig,\n  type Keypair,\n  type RpcResponseAndContext,\n  type SignatureResult,\n  type SimulatedTransactionResponse,\n  type TokenAccountsFilter,\n} from \"@solana/web3.js\";\n\n/** Subset of a qorechain-sdk network's endpoints relevant to the SVM runtime. */\nexport interface SvmEndpoints {\n  /** Solana-compatible JSON-RPC HTTP endpoint. */\n  svmRpc: string;\n}\n\n/** Default testnet SVM RPC endpoint (Solana-compatible JSON-RPC, port 8899). */\nexport const DEFAULT_SVM_RPC_URL = \"http://localhost:8899\";\n\n/** Options for {@link createSvmClient}. */\nexport interface CreateSvmClientOptions {\n  /** Solana-compatible JSON-RPC HTTP URL. Mutually exclusive with `endpoints`. */\n  rpcUrl?: string;\n  /** A qorechain-sdk network endpoints object (uses `svmRpc`). */\n  endpoints?: SvmEndpoints;\n  /** Default commitment level for the connection. */\n  commitment?: Commitment;\n  /**\n   * A preconstructed `Connection`. When provided it is used as-is and `rpcUrl`/\n   * `endpoints`/`commitment` are ignored — primarily for testing.\n   */\n  connection?: Connection;\n}\n\n/** Arguments for building/sending a SOL transfer. */\nexport interface TransferSolArgs {\n  /** Funding/source keypair (signer). */\n  from: Keypair;\n  /** Destination address. */\n  to: PublicKey;\n  /** Amount in lamports. */\n  lamports: number | bigint;\n}\n\n/** A configured QoreChain SVM client bundle. */\nexport interface SvmClient {\n  /** The underlying `@solana/web3.js` `Connection`. */\n  connection: Connection;\n\n  // --- Reads (thin wrappers over the JSON-RPC method set) ---\n  /** Lamport balance for an account. */\n  getBalance(pubkey: PublicKey, commitment?: Commitment): Promise<number>;\n  /** Raw account info, or `null` if the account does not exist. */\n  getAccountInfo(\n    pubkey: PublicKey,\n    commitment?: Commitment,\n  ): Promise<AccountInfo<Buffer> | null>;\n  /** Latest blockhash and last valid block height. */\n  getLatestBlockhash(\n    commitmentOrConfig?: Commitment | GetLatestBlockhashConfig,\n  ): Promise<{ blockhash: string; lastValidBlockHeight: number }>;\n  /** Token accounts owned by `owner`, filtered by mint or program id. */\n  getTokenAccountsByOwner(\n    owner: PublicKey,\n    filter: TokenAccountsFilter,\n    commitment?: Commitment,\n  ): ReturnType<Connection[\"getTokenAccountsByOwner\"]>;\n  /** Confirmed signatures for transactions involving `address`. */\n  getSignaturesForAddress(\n    address: PublicKey,\n    options?: Parameters<Connection[\"getSignaturesForAddress\"]>[1],\n  ): ReturnType<Connection[\"getSignaturesForAddress\"]>;\n  /** Request an airdrop of `lamports` to `pubkey` (testnet/devnet only). */\n  requestAirdrop(pubkey: PublicKey, lamports: number): Promise<string>;\n\n  // --- Transactions ---\n  /** Build (unsigned, no blockhash) a SOL transfer transaction. */\n  buildTransferSol(args: TransferSolArgs): Transaction;\n  /** Build, sign, send, and confirm a SOL transfer. */\n  transferSol(args: TransferSolArgs, options?: ConfirmOptions): Promise<string>;\n  /** Sign, send, and confirm an arbitrary transaction. */\n  sendTransaction(\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string>;\n  /** Simulate a transaction without submitting it. */\n  simulateTransaction(\n    tx: Transaction,\n  ): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;\n}\n\nfunction resolveConnection(opts: CreateSvmClientOptions): Connection {\n  if (opts.connection) return opts.connection;\n  const url = opts.rpcUrl ?? opts.endpoints?.svmRpc ?? DEFAULT_SVM_RPC_URL;\n  return new Connection(url, opts.commitment ?? \"confirmed\");\n}\n\n/**\n * Create a QoreChain SVM client bundle.\n *\n * With no options it targets the testnet localhost endpoint\n * (`http://localhost:8899`) at `confirmed` commitment.\n */\nexport function createSvmClient(opts: CreateSvmClientOptions = {}): SvmClient {\n  const connection = resolveConnection(opts);\n\n  const buildTransferSol = (args: TransferSolArgs): Transaction => {\n    const tx = new Transaction();\n    tx.add(\n      SystemProgram.transfer({\n        fromPubkey: args.from.publicKey,\n        toPubkey: args.to,\n        lamports: args.lamports,\n      }),\n    );\n    return tx;\n  };\n\n  const sendTransaction = (\n    tx: Transaction,\n    signers: Keypair[],\n    options?: ConfirmOptions,\n  ): Promise<string> => sendAndConfirmTransaction(connection, tx, signers, options);\n\n  return {\n    connection,\n\n    getBalance: (pubkey, commitment) => connection.getBalance(pubkey, commitment),\n    getAccountInfo: (pubkey, commitment) =>\n      connection.getAccountInfo(pubkey, commitment) as Promise<AccountInfo<Buffer> | null>,\n    getLatestBlockhash: (commitmentOrConfig) =>\n      connection.getLatestBlockhash(commitmentOrConfig),\n    getTokenAccountsByOwner: (owner, filter, commitment) =>\n      connection.getTokenAccountsByOwner(owner, filter, commitment),\n    getSignaturesForAddress: (address, options) =>\n      connection.getSignaturesForAddress(address, options),\n    requestAirdrop: (pubkey, lamports) => connection.requestAirdrop(pubkey, lamports),\n\n    buildTransferSol,\n    transferSol: (args, options) =>\n      sendTransaction(buildTransferSol(args), [args.from], options),\n    sendTransaction,\n    simulateTransaction: (tx): Promise<\n      RpcResponseAndContext<SimulatedTransactionResponse>\n    > =>\n      // The single-arg overload signs/derives blockhash as needed for v1\n      // legacy transactions.\n      (connection.simulateTransaction as (\n        t: Transaction,\n      ) => Promise<RpcResponseAndContext<SimulatedTransactionResponse>>)(tx),\n  };\n}\n\n// Re-export so callers can type their results without a direct dependency on the\n// peer's internal `SignatureResult` import path.\nexport type { SignatureResult };\n","/**\n * Key helpers for QoreChain's Solana-compatible runtime.\n *\n * These are thin wrappers over `@solana/web3.js` so callers don't need a second\n * import path. `@qorechain/sdk`'s `deriveSvmAccount(mnemonic)` provides the\n * 64-byte `secretKey` you can pass straight into {@link svmKeypairFromSecretKey}.\n */\n\nimport { Keypair, PublicKey } from \"@solana/web3.js\";\n\n/**\n * Reconstruct a `@solana/web3.js` `Keypair` from a 64-byte ed25519 secret key\n * (the standard Solana secret-key encoding: 32-byte seed + 32-byte public key).\n *\n * Pair with `@qorechain/sdk`'s `deriveSvmAccount`, which returns this exact\n * 64-byte `secretKey`.\n */\nexport function svmKeypairFromSecretKey(secretKey: Uint8Array): Keypair {\n  if (secretKey.length !== 64) {\n    throw new Error(\n      `svmKeypairFromSecretKey: expected a 64-byte secret key, got ${secretKey.length}`,\n    );\n  }\n  return Keypair.fromSecretKey(secretKey);\n}\n\n/** Return the base58 address for a `Keypair` or a `PublicKey`. */\nexport function svmAddress(key: Keypair | PublicKey): string {\n  const pubkey = key instanceof PublicKey ? key : key.publicKey;\n  return pubkey.toBase58();\n}\n","/**\n * Well-known native program ids for QoreChain's Solana-compatible runtime, plus\n * thin instruction builders for the Memo and SPL-Token programs and the\n * Associated Token Account program.\n *\n * The program ids are the exact canonical ones used by Solana-compatible\n * runtimes, so standard wallets, explorers, and tooling interoperate directly.\n * The SPL-Token / ATA / Memo instructions are built minimally here (by hand)\n * to keep the dependency surface to a single peer — `@solana/web3.js` — with no\n * `@solana/spl-token` requirement.\n */\n\nimport { PublicKey, TransactionInstruction, type AccountMeta } from \"@solana/web3.js\";\n\n/** System program (account creation, SOL transfers). */\nexport const SYSTEM_PROGRAM_ID = new PublicKey(\"11111111111111111111111111111111\");\n\n/** SPL-Token program. */\nexport const TOKEN_PROGRAM_ID = new PublicKey(\"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\");\n\n/** Associated Token Account program. */\nexport const ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(\n  \"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL\",\n);\n\n/** SPL Memo program. */\nexport const MEMO_PROGRAM_ID = new PublicKey(\"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\");\n\n/** Convenience grouping of the well-known program ids. */\nexport const PROGRAM_IDS = {\n  system: SYSTEM_PROGRAM_ID,\n  token: TOKEN_PROGRAM_ID,\n  associatedToken: ASSOCIATED_TOKEN_PROGRAM_ID,\n  memo: MEMO_PROGRAM_ID,\n} as const;\n\n/**\n * Build a Memo program instruction carrying `text` (encoded UTF-8).\n *\n * @param text    Memo contents.\n * @param signers Optional accounts that must sign the memo; each is included as\n *                a read-only signer (the Memo program's convention).\n */\nexport function createMemoInstruction(\n  text: string,\n  signers: PublicKey[] = [],\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId: MEMO_PROGRAM_ID,\n    keys: signers.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n    data: Buffer.from(text, \"utf8\"),\n  });\n}\n\n/** Arguments for {@link createTransferTokenInstruction}. */\nexport interface TransferTokenInstructionArgs {\n  /** Source SPL-Token account. */\n  source: PublicKey;\n  /** Destination SPL-Token account. */\n  destination: PublicKey;\n  /** Owner/authority of the source account (signer). */\n  owner: PublicKey;\n  /** Amount in the token's base units. */\n  amount: bigint;\n  /** Additional multisig signers, if `owner` is a multisig. */\n  multiSigners?: PublicKey[];\n}\n\n/**\n * Build an SPL-Token `Transfer` instruction.\n *\n * Layout: 1 byte instruction discriminator (`3` = Transfer) followed by a\n * little-endian u64 amount.\n */\nexport function createTransferTokenInstruction(\n  args: TransferTokenInstructionArgs,\n): TransactionInstruction {\n  const { source, destination, owner, amount, multiSigners = [] } = args;\n\n  const data = Buffer.alloc(9);\n  data.writeUInt8(3, 0);\n  data.writeBigUInt64LE(amount, 1);\n\n  const keys: AccountMeta[] = [\n    { pubkey: source, isSigner: false, isWritable: true },\n    { pubkey: destination, isSigner: false, isWritable: true },\n    {\n      pubkey: owner,\n      isSigner: multiSigners.length === 0,\n      isWritable: false,\n    },\n    ...multiSigners.map((pubkey) => ({ pubkey, isSigner: true, isWritable: false })),\n  ];\n\n  return new TransactionInstruction({ programId: TOKEN_PROGRAM_ID, keys, data });\n}\n\n/**\n * Derive the deterministic Associated Token Account (ATA) address for an owner\n * and mint under the SPL-Token program.\n */\nexport function getAssociatedTokenAddress(\n  mint: PublicKey,\n  owner: PublicKey,\n  tokenProgramId: PublicKey = TOKEN_PROGRAM_ID,\n): PublicKey {\n  const [address] = PublicKey.findProgramAddressSync(\n    [owner.toBuffer(), tokenProgramId.toBuffer(), mint.toBuffer()],\n    ASSOCIATED_TOKEN_PROGRAM_ID,\n  );\n  return address;\n}\n\n/** Arguments for {@link createAssociatedTokenAccountInstruction}. */\nexport interface CreateAssociatedTokenAccountInstructionArgs {\n  /** Account funding the rent for the new ATA (signer, writable). */\n  payer: PublicKey;\n  /** Wallet that will own the new ATA. */\n  owner: PublicKey;\n  /** Token mint. */\n  mint: PublicKey;\n  /** SPL-Token program id (defaults to the canonical SPL-Token program). */\n  tokenProgramId?: PublicKey;\n}\n\n/**\n * Build an instruction that creates the Associated Token Account for\n * `(owner, mint)`. The ATA address is derived deterministically.\n */\nexport function createAssociatedTokenAccountInstruction(\n  args: CreateAssociatedTokenAccountInstructionArgs,\n): TransactionInstruction {\n  const { payer, owner, mint, tokenProgramId = TOKEN_PROGRAM_ID } = args;\n  const ata = getAssociatedTokenAddress(mint, owner, tokenProgramId);\n\n  const keys: AccountMeta[] = [\n    { pubkey: payer, isSigner: true, isWritable: true },\n    { pubkey: ata, isSigner: false, isWritable: true },\n    { pubkey: owner, isSigner: false, isWritable: false },\n    { pubkey: mint, isSigner: false, isWritable: false },\n    { pubkey: SYSTEM_PROGRAM_ID, isSigner: false, isWritable: false },\n    { pubkey: tokenProgramId, isSigner: false, isWritable: false },\n  ];\n\n  // The ATA \"Create\" instruction takes empty data (the idempotent variant uses\n  // a single 0x01 byte; this is the plain create).\n  return new TransactionInstruction({\n    programId: ASSOCIATED_TOKEN_PROGRAM_ID,\n    keys,\n    data: Buffer.alloc(0),\n  });\n}\n\n/**\n * Generic instruction builder for invoking an arbitrary on-chain program.\n *\n * Use this with {@link createSvmClient}'s `sendTransaction` to call a deployed\n * BPF program. Deploy programs with standard Solana tooling (e.g.\n * `solana program deploy`); this package intentionally does not wrap the loader.\n */\nexport function createInvokeInstruction(\n  programId: PublicKey,\n  keys: AccountMeta[],\n  data: Uint8Array,\n): TransactionInstruction {\n  return new TransactionInstruction({\n    programId,\n    keys,\n    data: Buffer.from(data),\n  });\n}\n","/**\n * SVM browser-wallet integration for QoreChain (Phantom and Wallet-Standard).\n *\n * Adapts an injected Solana provider (Phantom's `window.solana` is the baseline)\n * into a shape usable with `@solana/web3.js`, so apps can sign and send via the\n * existing SVM client.\n *\n * ```ts\n * import { getSvmWallet } from \"@qorechain/svm\";\n * import { createSvmClient } from \"@qorechain/svm\";\n *\n * const wallet = await getSvmWallet();\n * const signed = await wallet.signTransaction(tx);\n * // ...then send with createSvmClient(...).sendRawTransaction(...)\n * ```\n */\n\nimport type { PublicKey, Transaction, VersionedTransaction } from \"@solana/web3.js\";\n\n/** A transaction the wallet can sign (legacy or versioned). */\nexport type SvmSignableTransaction = Transaction | VersionedTransaction;\n\n/**\n * The minimal injected Solana-wallet surface used here. Phantom (and most\n * Wallet-Standard providers) implement at least these. Declared structurally so\n * no wallet types package is required.\n */\nexport interface InjectedSvmWallet {\n  /** Phantom marker; present on the Phantom provider. */\n  isPhantom?: boolean;\n  /** Connect and return the account public key. */\n  connect(opts?: { onlyIfTrusted?: boolean }): Promise<{ publicKey: PublicKey }>;\n  /** Disconnect the wallet. */\n  disconnect?(): Promise<void>;\n  /** The connected account public key (populated after `connect`). */\n  publicKey?: PublicKey | null;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions. */\n  signAllTransactions?<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n}\n\n/** Window augmentation for the default injected Solana provider. */\ninterface SolanaWindow {\n  solana?: InjectedSvmWallet;\n}\n\n/** Options for {@link getSvmWallet}. */\nexport interface GetSvmWalletOptions {\n  /** The injected provider to use. Defaults to `window.solana` (Phantom). */\n  provider?: InjectedSvmWallet;\n  /** Pass through to the provider's `connect` (e.g. silent reconnect). */\n  onlyIfTrusted?: boolean;\n}\n\n/**\n * A connected SVM wallet adapted for use with `@solana/web3.js`.\n *\n * `signTransaction` / `signAllTransactions` accept and return web3.js\n * `Transaction` / `VersionedTransaction` objects, so they drop into the existing\n * SVM client's send path.\n */\nexport interface SvmWalletConnection {\n  /** The connected account public key. */\n  publicKey: PublicKey;\n  /** Sign a single transaction. */\n  signTransaction<T extends SvmSignableTransaction>(tx: T): Promise<T>;\n  /** Sign multiple transactions (falls back to sequential signing). */\n  signAllTransactions<T extends SvmSignableTransaction>(txs: T[]): Promise<T[]>;\n  /** The underlying injected provider. */\n  provider: InjectedSvmWallet;\n}\n\n/** Resolve the injected Solana provider from options or `window`, or throw. */\nfunction resolveProvider(provider?: InjectedSvmWallet): InjectedSvmWallet {\n  if (provider) return provider;\n  if (typeof window === \"undefined\") {\n    throw new Error(\n      \"getSvmWallet: no browser `window` available. Run in a browser, or pass `provider` explicitly.\",\n    );\n  }\n  const injected = (window as unknown as SolanaWindow).solana;\n  if (!injected) {\n    throw new Error(\n      \"getSvmWallet: no injected Solana provider found (window.solana). Install Phantom, or pass `provider`.\",\n    );\n  }\n  return injected;\n}\n\n/**\n * Connect to an injected Solana wallet (Phantom by default) and return an\n * adapter usable with `@solana/web3.js`.\n *\n * Browser-only: throws a clear error if no `window` or no injected provider.\n */\nexport async function getSvmWallet(\n  opts: GetSvmWalletOptions = {},\n): Promise<SvmWalletConnection> {\n  const provider = resolveProvider(opts.provider);\n  const { publicKey } = await provider.connect(\n    opts.onlyIfTrusted ? { onlyIfTrusted: true } : undefined,\n  );\n  if (!publicKey) {\n    throw new Error(\"getSvmWallet: wallet connected but returned no public key\");\n  }\n\n  const signTransaction = <T extends SvmSignableTransaction>(tx: T): Promise<T> =>\n    provider.signTransaction(tx);\n\n  const signAllTransactions = async <T extends SvmSignableTransaction>(\n    txs: T[],\n  ): Promise<T[]> => {\n    if (provider.signAllTransactions) return provider.signAllTransactions(txs);\n    // Fall back to signing sequentially for providers without batch support.\n    const out: T[] = [];\n    for (const tx of txs) out.push(await provider.signTransaction(tx));\n    return out;\n  };\n\n  return { publicKey, signTransaction, signAllTransactions, provider };\n}\n\n/**\n * Detect a Wallet-Standard / Phantom Solana provider on `window`.\n *\n * Returns the injected provider if present, else `undefined`. Phantom's\n * `window.solana` is the baseline; this is a light convenience for apps that\n * want to feature-detect before prompting a connection.\n */\nexport function detectSvmProvider(): InjectedSvmWallet | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  return (window as unknown as SolanaWindow).solana;\n}\n","/**\n * Human-readable decoding of SVM (Solana-compatible) transaction errors.\n *\n * `@solana/web3.js` throws a `SendTransactionError` (and related shapes) whose\n * useful detail — the failing instruction index, a program's custom error code,\n * and the program logs — is spread across several fields that differ slightly\n * between library versions. {@link decodeSvmError} reads those fields\n * structurally (so it works across versions) and produces a flat summary with\n * the program logs and, where present, the failing instruction index.\n */\n\n/** A decoded SVM error. */\nexport interface DecodedSvmError {\n  /** A readable summary message. */\n  message: string;\n  /** A short, stable kind discriminator. */\n  kind: \"instruction_error\" | \"simulation\" | \"send\" | \"unknown\";\n  /** Zero-based index of the failing instruction, when determinable. */\n  instructionIndex?: number;\n  /** A program's custom error code, when present in the logs. */\n  customErrorCode?: number;\n  /** The program logs, when available. */\n  logs?: string[];\n}\n\n/** Read the program logs from the various shapes web3.js uses. */\nfunction extractLogs(err: unknown): string[] | undefined {\n  const e = err as { logs?: unknown; transactionLogs?: unknown };\n  const logs = e?.logs ?? e?.transactionLogs;\n  if (Array.isArray(logs)) return logs as string[];\n  return undefined;\n}\n\n/** Read a base message from the various shapes web3.js uses. */\nfunction extractMessage(err: unknown): string {\n  const e = err as { transactionMessage?: unknown; message?: unknown };\n  if (typeof e?.transactionMessage === \"string\" && e.transactionMessage) {\n    return e.transactionMessage;\n  }\n  if (typeof e?.message === \"string\" && e.message) return e.message;\n  return String(err);\n}\n\n/**\n * Parse the failing instruction index and a custom program error code from the\n * program logs, if either is present.\n *\n * Logs commonly contain a line like:\n *   \"Program <id> failed: custom program error: 0x1\"\n * and the instruction index can appear as \"Error processing Instruction 2:\".\n */\nfunction parseFromLogs(logs: string[] | undefined): {\n  instructionIndex?: number;\n  customErrorCode?: number;\n} {\n  if (!logs) return {};\n  let instructionIndex: number | undefined;\n  let customErrorCode: number | undefined;\n  for (const line of logs) {\n    const instr = /instruction\\s+#?(\\d+)/i.exec(line);\n    if (instr) instructionIndex = Number(instr[1]);\n    const custom = /custom program error:\\s*(0x[0-9a-fA-F]+|\\d+)/i.exec(line);\n    if (custom) {\n      customErrorCode = custom[1].startsWith(\"0x\")\n        ? parseInt(custom[1], 16)\n        : Number(custom[1]);\n    }\n  }\n  return { instructionIndex, customErrorCode };\n}\n\n/**\n * Decode an SVM error thrown by `@solana/web3.js` into a readable, structured\n * form.\n *\n * @param error - The thrown error (a `SendTransactionError` or any value).\n */\nexport function decodeSvmError(error: unknown): DecodedSvmError {\n  const logs = extractLogs(error);\n  const base = extractMessage(error);\n  const { instructionIndex, customErrorCode } = parseFromLogs(logs);\n\n  const name = (error as { name?: string })?.name;\n  const isSendError =\n    name === \"SendTransactionError\" ||\n    /simulation failed|transaction simulation/i.test(base);\n\n  const parts: string[] = [base];\n  if (instructionIndex !== undefined) {\n    parts.push(`(failing instruction #${instructionIndex})`);\n  }\n  if (customErrorCode !== undefined) {\n    parts.push(`(custom program error ${customErrorCode})`);\n  }\n\n  let kind: DecodedSvmError[\"kind\"];\n  if (customErrorCode !== undefined || instructionIndex !== undefined) {\n    kind = \"instruction_error\";\n  } else if (isSendError) {\n    kind = \"simulation\";\n  } else if (error instanceof Error) {\n    kind = \"send\";\n  } else {\n    kind = \"unknown\";\n  }\n\n  return {\n    message: parts.join(\" \"),\n    kind,\n    instructionIndex,\n    customErrorCode,\n    logs,\n  };\n}\n","/**\n * Real-time SVM subscriptions over the `@solana/web3.js` `Connection`.\n *\n * The `Connection` owns the websocket and its lifecycle; these helpers are thin\n * wrappers that register a listener and return both the numeric subscription id\n * and an `off()` function that removes it via the matching\n * `remove*Listener` call. This keeps callers from having to remember which\n * removal method pairs with which subscription.\n */\n\nimport type {\n  AccountChangeCallback,\n  Commitment,\n  Connection,\n  LogsCallback,\n  LogsFilter,\n  PublicKey,\n  SlotChangeCallback,\n} from \"@solana/web3.js\";\n\n/** A registered subscription: its id and a function to remove it. */\nexport interface SvmSubscription {\n  /** The numeric subscription id returned by `@solana/web3.js`. */\n  id: number;\n  /** Remove the listener (idempotent best-effort). */\n  off(): Promise<void>;\n}\n\n/**\n * Subscribe to transaction logs matching `filter`.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param filter - A `LogsFilter` (`\"all\"`, `\"allWithVotes\"`, or a `PublicKey`).\n * @param callback - Invoked with each matching logs notification.\n * @param commitment - Optional commitment level.\n */\nexport function onLogs(\n  connection: Connection,\n  filter: LogsFilter,\n  callback: LogsCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onLogs(filter, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeOnLogsListener(id),\n  };\n}\n\n/**\n * Subscribe to changes of an account's data.\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param pubkey - The account to watch.\n * @param callback - Invoked with each account change.\n * @param commitment - Optional commitment level.\n */\nexport function onAccountChange(\n  connection: Connection,\n  pubkey: PublicKey,\n  callback: AccountChangeCallback,\n  commitment?: Commitment,\n): SvmSubscription {\n  const id = connection.onAccountChange(pubkey, callback, commitment);\n  return {\n    id,\n    off: () => connection.removeAccountChangeListener(id),\n  };\n}\n\n/**\n * Subscribe to slot changes (new slots as they are processed).\n *\n * @param connection - A `@solana/web3.js` `Connection`.\n * @param callback - Invoked with each slot change.\n */\nexport function onSlotChange(\n  connection: Connection,\n  callback: SlotChangeCallback,\n): SvmSubscription {\n  const id = connection.onSlotChange(callback);\n  return {\n    id,\n    off: () => connection.removeSlotChangeListener(id),\n  };\n}\n","/**\n * Compute-budget and priority-fee conveniences over `@solana/web3.js`.\n *\n * {@link withComputeBudget} prepends `ComputeBudgetProgram` instructions to a\n * legacy `Transaction` so it requests a compute-unit limit and pays a per-CU\n * priority price; {@link estimatePriorityFee} reads recent prioritization fees\n * from the RPC to suggest a `microLamports` price.\n */\n\nimport {\n  ComputeBudgetProgram,\n  type Connection,\n  type PublicKey,\n  type Transaction,\n} from \"@solana/web3.js\";\n\n/** Compute-budget options for {@link withComputeBudget}. */\nexport interface ComputeBudgetOptions {\n  /** Compute-unit limit to request (`setComputeUnitLimit`). */\n  units?: number;\n  /** Per-compute-unit price in micro-lamports (`setComputeUnitPrice`). */\n  microLamports?: number | bigint;\n}\n\n/**\n * Prepend `ComputeBudgetProgram` instructions to `tx` (mutating it in place and\n * returning it). A unit-limit instruction is added when `units` is given, and a\n * unit-price instruction when `microLamports` is given; both are inserted at the\n * front of the instruction list, as required by the runtime.\n *\n * @returns The same `tx`, for chaining.\n */\nexport function withComputeBudget(\n  tx: Transaction,\n  options: ComputeBudgetOptions,\n): Transaction {\n  const { units, microLamports } = options;\n  const prepend = [];\n  if (microLamports !== undefined) {\n    prepend.unshift(\n      ComputeBudgetProgram.setComputeUnitPrice({ microLamports }),\n    );\n  }\n  if (units !== undefined) {\n    prepend.unshift(ComputeBudgetProgram.setComputeUnitLimit({ units }));\n  }\n  tx.instructions.unshift(...prepend);\n  return tx;\n}\n\n/**\n * Estimate a priority fee (`microLamports` per CU) from the RPC's\n * `getRecentPrioritizationFees`. Returns the maximum recently observed fee,\n * which is a conservative choice for landing a transaction quickly. Returns `0`\n * when the RPC reports no recent fees.\n *\n * @param connection - SVM RPC connection.\n * @param accounts   - Optional accounts the tx will lock, scoping the query.\n */\nexport async function estimatePriorityFee(\n  connection: Connection,\n  accounts: readonly PublicKey[] = [],\n): Promise<number> {\n  const fees = await connection.getRecentPrioritizationFees(\n    accounts.length > 0 ? { lockedWritableAccounts: [...accounts] } : undefined,\n  );\n  if (!fees || fees.length === 0) return 0;\n  return fees.reduce((max, f) => Math.max(max, f.prioritizationFee), 0);\n}\n\n/** Namespaced compute-budget / fee helpers. */\nexport const fees = {\n  withComputeBudget,\n  estimatePriorityFee,\n} as const;\n","/**\n * `@qorechain/svm` — a thin, type-safe adapter over\n * [`@solana/web3.js`](https://solana-labs.github.io/solana-web3.js/) for\n * QoreChain's Solana-compatible JSON-RPC.\n *\n * It does not reimplement an SVM client; `@solana/web3.js` is a peer dependency.\n * This package adds QoreChain-specific conveniences: a client factory targeting\n * the SVM RPC endpoint, key helpers, typed read wrappers, SOL transfer\n * build/sign/send, and minimal native-program instruction builders (Memo,\n * SPL-Token, Associated Token Account) plus a generic program-invoke builder.\n */\n\n/** Package version. */\nexport const VERSION = \"0.5.0\";\n\nexport {\n  createSvmClient,\n  DEFAULT_SVM_RPC_URL,\n  type CreateSvmClientOptions,\n  type SvmClient,\n  type SvmEndpoints,\n  type TransferSolArgs,\n  type SignatureResult,\n} from \"./client\";\n\nexport { svmKeypairFromSecretKey, svmAddress } from \"./keys\";\n\nexport {\n  PROGRAM_IDS,\n  SYSTEM_PROGRAM_ID,\n  TOKEN_PROGRAM_ID,\n  ASSOCIATED_TOKEN_PROGRAM_ID,\n  MEMO_PROGRAM_ID,\n  createMemoInstruction,\n  createTransferTokenInstruction,\n  createAssociatedTokenAccountInstruction,\n  getAssociatedTokenAddress,\n  createInvokeInstruction,\n  type TransferTokenInstructionArgs,\n  type CreateAssociatedTokenAccountInstructionArgs,\n} from \"./programs\";\n\nexport {\n  getSvmWallet,\n  detectSvmProvider,\n  type InjectedSvmWallet,\n  type GetSvmWalletOptions,\n  type SvmWalletConnection,\n  type SvmSignableTransaction,\n} from \"./wallet\";\n\nexport { decodeSvmError, type DecodedSvmError } from \"./errors\";\n\nexport {\n  onLogs,\n  onAccountChange,\n  onSlotChange,\n  type SvmSubscription,\n} from \"./subscribe\";\n\nexport {\n  fees,\n  withComputeBudget,\n  estimatePriorityFee,\n  type ComputeBudgetOptions,\n} from \"./fees\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qorechain/svm",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "QoreChain SVM adapter: thin, type-safe conveniences over @solana/web3.js for QoreChain's Solana-compatible JSON-RPC, including SOL transfers, native program IDs, and SPL-Token/Memo instruction helpers.",
   "license": "Apache-2.0",
   "author": "QoreChain",
@@ -19,13 +19,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src test"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/qorechain/qorechain-sdk.git",
@@ -47,5 +40,12 @@
     "tsup": "^8.3.0",
     "typescript": "^5.6.3",
     "vitest": "^2.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src test"
   }
-}
+}