First version

Author: earrietadev

.gitignore

@@ -0,0 +1 @@
+.idea

LICENCE.md

@@ -0,0 +1,16 @@
+MIT License
+
+Copyright (c) 2025 Creit Technologies LLP.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,108 @@
+# Stellar Router SDK
+
+The Stellar Router is a simple smart contract that you can use to execute multiple contract calls at the same time.
+
+Why doing this? Well by doing this you can "simulate" the feature the classic side has where you could make multiple
+operations at the same time, with soroban you are limited to a single operation per transaction but by using this router
+you can make multiple soroban calls at once from your website.
+
+## Install the SDK
+
+You can install the SDK from JSR by doing:
+
+```shell
+npx jsr add @creit-tech/stellar-assets-sdk
+```
+
+You can check more installation methods (deno, pnpm, etc) from [here](https://jsr.io/@creit-tech/stellar-router-sdk/)
+
+## How to use
+
+Because the library it's pretty simple, using is also simple. Here is an example of us fetching a list of 19 balances
+from different contracts calls at once.
+
+```typescript
+import { StellarRouterSdk } from "@creit-tech/stellar-router-sdk";
+
+const assets: string[] = [
+  "CAUIKL3IYGMERDRUN6YSCLWVAKIFG5Q4YJHUKM4S4NJZQIA3BAS6OJPK",
+  "CD25MNVTZDL4Y3XBCPCJXGXATV5WUHHOWMYFF4YBEGU5FCPGMYTVG5JY",
+  "CAO7DDJNGMOYQPRYDY5JVZ5YEK4UQBSMGLAEWRCUOTRMDSBMGWSAATDZ",
+  "CBH4M45TQBLDPXOK6L7VYKMEJWFITBOL64BN3WDAIIDT4LNUTWTTOCKF",
+  "CDTKPWPLOURQA2SGTKTUQOWRCBZEORB4BWBOMJ3D3ZTQQSGE5F6JBQLV",
+  "CBN3NCJSMOQTC6SPEYK3A44NU4VS3IPKTARJLI3Y77OH27EWBY36TP7U",
+  "CBCO65UOWXY2GR66GOCMCN6IU3Y45TXCPBY3FLUNL4AOUMOCKVIVV6JC",
+  "CCKCKCPHYVXQD4NECBFJTFSCU2AMSJGCNG4O6K4JVRE2BLPR7WNDBQIQ",
+  "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
+  "CB226ZOEYXTBPD3QEGABTJYSKZVBP2PASEISLG3SBMTN5CE4QZUVZ3CE",
+  "CDIKURWHYS4FFTR5KOQK6MBFZA2K3E26WGBQI6PXBYWZ4XIOPJHDFJKP",
+  "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA",
+  "CBLLEW7HD2RWATVSMLAGWM4G3WCHSHDJ25ALP4DI6LULV5TU35N2CIZA",
+  "CAAV3AE3VKD2P4TY7LWTQMMJHIJ4WOCZ5ANCIJPC3NRSERKVXNHBU2W7",
+  "CDCKFBZYF2AQCSM3JOF2ZM27O3Y6AJAI4OTCQKAFNZ3FHBYUTFOKICIY",
+  "CB2XMFB6BDIHFOSFB5IXHDOYV3SI3IXMNIZLPDZHC7ENDCXSBEBZAO2Y",
+  "CBRP2VD3CZLEQIQZ4JMBXGA5AC2U6JE26YU5CCIOICIZCVWPGBO2QRUB",
+  "CDYEOOVL6WV4JRY45CXQKOBJFFAPOM5KNQCCDNM333L6RM2L4RO3LKYG",
+  "CBZVSNVB55ANF24QVJL2K5QCLOAB6XITGTGXYEAF6NPTXYKEJUYQOHFC",
+];
+
+const sdk: StellarRouterSdk = new StellarRouterSdk({ rpcUrl: "https://mainnet.sorobanrpc.com" });
+const xbullSwapContract: string = "CB3JAPDEIMA3OOSALUHLYRGM2QTXGVD3EASALPFMVEU2POLLULJBT2XN";
+const invocations: Invocation[] = assets.map((contract: string): Invocation => ({
+  contract,
+  method: "balance",
+  args: [new Address(xbullSwapContract).toScVal()],
+}));
+
+const balances: bigint[] = await sdk.simResult(invocations);
+```
+
+But you can also generate the operations for you to use in your own transaction and execute them, here is an example of
+burning and registering again a domain in the SorobanDomains contract (basically, doing a "renew" without the contract
+directly supporting it).
+
+```typescript
+import { SorobanDomainsSDK } from "@creit-tech/sorobandomains-sdk";
+import { StellarRouterSdk } from "@creit-tech/stellar-router-sdk";
+import { xdr } from "@stellar/stellar-sdk";
+
+const routerSdk = new StellarRouterSdk();
+const domainsSdk = new SorobanDomainsSDK(PARAMS);
+const domain = "superawesomeimpossibledomain";
+const domainsContract = "CATRNPHYKNXAPNLHEYH55REB6YSAJLGCPA4YM6L3WUKSZOPI77M2UMKI";
+const domainOwner: string = "GA3S4HZCLBXSA4T5SFNLTQNZ4VOJM3V2H2EN57RJPYFS2BVXX2PEXGPO";
+
+const { value } = await domainsSdk.searchDomain({ domain });
+
+const contractCall: xdr.Operation<Operation.InvokeHostFunction> = routerSdk.exec(
+  domainOwner,
+  [{
+    contract: domainsContract,
+    method: "burn_record",
+    args: [xdr.ScVal.scvVec([xdr.ScVal.scvSymbol("Record"), xdr.ScVal.scvBytes(new TextEncoder().encode(value.node))])],
+  }, {
+    contract: domainsContract,
+    method: "set_record",
+    args: [
+      nativeToScVal(new TextEncoder().encode(domain), { type: "bytes" }),
+      nativeToScVal(new TextEncoder().encode("xlm"), { type: "bytes" }),
+      nativeToScVal(value.address, { type: "address" }),
+      nativeToScVal(value.address, { type: "address" }),
+      nativeToScVal(3600n * 24n * 365n * 5n, { type: "u64" }),
+    ],
+  }],
+);
+
+// Now you build the transaction, add the operation from above and send it to the network.
+```
+
+The best thing about using this method, is that the transaction is also atomic so if something fails in the middle then
+the whole transaction fails. Just like with the classic side!
+
+## License
+
+![](https://img.shields.io/badge/License-MIT-lightgrey)
+
+Licensed under the MIT License, Copyright © 2025-present Creit Technologies LLP.
+
+Check out the `LICENSE.md` file for more details.

deno.json

@@ -0,0 +1,13 @@
+{
+  "name": "@creit-tech/stellar-router-sdk",
+  "version": "0.1.0",
+  "license": "MIT",
+  "exports": "./src/mod.ts",
+  "fmt": {
+    "lineWidth": 120
+  },
+  "imports": {
+    "@std/assert": "jsr:@std/assert@1",
+    "@stellar/stellar-sdk": "npm:@stellar/stellar-sdk@^13.2.0"
+  }
+}