@sun-protocol/sun-sdk-core 0.1.0-beta.0

package/NOTICE.md

@@ -0,0 +1,5 @@
+# @sun-protocol/sun-sdk-core Notice
+
+This package is derived from Uniswap SDK Core source code, used under the MIT license.
+
+Sun SDK keeps the upstream `sdk-core/src` directory shape and Token/Currency/Fraction semantics so SunSwap V2/V3/V4 packages can align with the Uniswap SDK architecture. TRON-specific changes are limited to Sun compatibility exports and native wrapped token constants such as WTRX.

package/README.md

@@ -0,0 +1,34 @@
+# @sun-protocol/sun-sdk-core
+
+Shared currency, amount, address, error, intent, and transaction action primitives for SUN SDK.
+
+## Install
+
+```bash
+npm install @sun-protocol/sun-sdk-core
+```
+
+## Example
+
+```ts
+import { Percent, createContractCallAction } from '@sun-protocol/sun-sdk-core'
+
+const slippage = new Percent(50, 10_000)
+const action = createContractCallAction({
+  id: 'approve-token',
+  target: token,
+  functionSelector: 'approve(address,uint256)',
+  parameters: [
+    { type: 'address', value: spender },
+    { type: 'uint256', value: '1000000' },
+  ],
+})
+```
+
+Primary exports include `Token`, `CurrencyAmount`, `Fraction`, `Percent`, `Price`, WTRX constants, TRON address helpers, `SDKError`, intents, and transaction action factories.
+
+Core has no protocol orchestration and never accesses a wallet, signs, or broadcasts. `Token` uses EVM-style addresses for Uniswap-compatible math, while runtime actions use TRON base58 addresses.
+
+Requires Node.js 20 or a compatible JavaScript runtime.
+
+[Full API documentation](https://github.com/sun-protocol/sun-sdk/blob/main/docs/sdk/api/core.md)