@juicedollar/jusd 1.0.0 → 1.0.2

package/README.md

@@ -139,9 +139,8 @@ yarn install
 Create a `.env` file (see `.env.example`):
 
 ```bash
-# Required: Use EITHER private key OR seed phrase
+# Required: Deployer wallet private key
 DEPLOYER_PRIVATE_KEY=your_private_key_here
-# DEPLOYER_ACCOUNT_SEED="twelve word seed phrase goes here"
 
 # Optional: For contract verification on Citrea explorer
 # CITREA_EXPLORER_API_KEY=your_api_key_here
@@ -247,26 +246,39 @@ npx hardhat ignition verify $DEPLOYMENT --include-unrelated-contracts
 ### Package Info
 
 - **Name**: `@juicedollar/jusd`
-- **Version**: `1.0.16` (see `package.json`)
+- **Version**: `1.0.0` (see `package.json`)
 - **Registry**: https://registry.npmjs.org
 
-### Build & Publish
+### First-Time Publish
 
 ```bash
-# 1. Update version in package.json
-# "version": "1.0.17"
+# 1. Login to NPM
+npm login
 
-# 2. Build TypeScript package
-yarn run build
+# 2. Publish (build happens automatically via prepublishOnly)
+yarn run publish
+```
 
-# 3. Login to NPM
-npm login
+### Publishing Updates
+
+```bash
+# 1. Update contracts (if changed)
+# Edit contracts, then export ABIs:
+yarn run ts:export:abis
+
+# 2. Update version in package.json (semantic versioning)
+# Patch: 1.0.0 → 1.0.1 (bug fixes)
+# Minor: 1.0.0 → 1.1.0 (new features)
+# Major: 1.0.0 → 2.0.0 (breaking changes)
+
+# 3. Commit changes
+git add . && git commit -m "Release v1.0.1: Description"
 
-# 4. Publish package
+# 4. Publish (build happens automatically)
 yarn run publish
 ```
 
-**Note:** The publish command may execute twice; the second will fail with a version conflict (expected behavior).
+**Note:** The `prepublishOnly` script automatically runs `yarn run build` before publishing.
 
 ### Package Exports
 

package/contracts/Equity.sol

@@ -29,10 +29,10 @@ contract Equity is ERC20Permit, ERC3009, MathUtil, IReserve, ERC165 {
      *
      * In the absence of fees, profits and losses, the variables grow as follows when JUICE tokens are minted:
      *
-     * |        Reserve     |      Market Cap    |     Price    |       Supply    |
-     * |              1_000 |             10_000 |       0.001  |      10_000_000 |
-     * |        100_000_000 |      1_000_000_000 |      31.62   |      31_622_777 |
-     * | 10_000_000_000_000 |100_000_000_000_000 | 1_000_000    |     100_000_000 |
+     * |            Reserve |          Market Cap |       Price  |          Supply |
+     * |              1_000 |              10_000 |      0.0001  |     100_000_000 |
+     * |        100_000_000 |       1_000_000_000 |       3.162  |     316_227_766 |
+     * | 10_000_000_000_000 | 100_000_000_000_000 |     100_000  |   1_000_000_000 |
      *
      * i.e., the supply is proportional to the tenth root of the reserve and the price is proportional to
      * the ninth power of the tenth root (or Reserve^0.9). When profits accumulate or losses materialize,
@@ -122,7 +122,7 @@ contract Equity is ERC20Permit, ERC3009, MathUtil, IReserve, ERC165 {
     function price() public view returns (uint256) {
         uint256 equity = JUSD.equity();
         if (equity == 0 || totalSupply() == 0) {
-            return 10 ** 14; 
+            return 10 ** 13;
         } else {
             return (VALUATION_FACTOR * JUSD.equity() * ONE_DEC18) / totalSupply();
         }
@@ -358,9 +358,9 @@ contract Equity is ERC20Permit, ERC3009, MathUtil, IReserve, ERC165 {
     function _calculateShares(uint256 capitalBefore, uint256 investment) internal view returns (uint256) {
         uint256 totalShares = totalSupply();
         uint256 investmentExFees = (investment * 980) / 1_000; // remove 2% fee
-        // Assign 10_000_000 JUICE for the initial deposit, calculate the amount otherwise
+        // Assign 100_000_000 JUICE for the initial deposit, calculate the amount otherwise
         uint256 newTotalShares = (capitalBefore < MINIMUM_EQUITY || totalShares == 0)
-            ? totalShares + 10_000_000 * ONE_DEC18
+            ? totalShares + 100_000_000 * ONE_DEC18
             : _mulD18(totalShares, _tenthRoot(_divD18(capitalBefore + investmentExFees, capitalBefore)));
         return newTotalShares - totalShares;
     }

package/contracts/MintingHubV2/MintingHub.sol

@@ -134,8 +134,8 @@ contract MintingHub is IMintingHub, ERC165 {
                 bytes memory /*lowLevelData*/
             ) {}
             if (_initialCollateral < _minCollateral) revert InsufficientCollateral();
-            // must start with at least 5000 JUSD worth of collateral
-            if (_minCollateral * _liqPrice < 5000 ether * 10 ** 18) revert InsufficientCollateral();
+            // must start with at least 100 JUSD worth of collateral
+            if (_minCollateral * _liqPrice < 100 ether * 10 ** 18) revert InsufficientCollateral();
         }
         IPosition pos = IPosition(
             POSITION_FACTORY.createNewPosition(

package/contracts/MintingHubV2/Position.sol

@@ -140,6 +140,7 @@ contract Position is Ownable, IPosition, MathUtil {
     error InvalidExpiration();
     error AlreadyInitialized();
     error PriceTooHigh(uint256 newPrice, uint256 maxPrice);
+    error InvalidPriceReference();
 
     modifier alive() {
         if (block.timestamp >= expiration) revert Expired(uint40(block.timestamp), expiration);
@@ -313,6 +314,25 @@ contract Position is Ownable, IPosition, MathUtil {
      * and the price in one transaction.
      */
     function adjust(uint256 newPrincipal, uint256 newCollateral, uint256 newPrice) external onlyOwner {
+        _adjust(newPrincipal, newCollateral, newPrice, address(0));
+    }
+
+    /**
+     * @notice "All in one" function to adjust the principal, the collateral amount,
+     * and the price in one transaction, with optional reference position for cooldown-free price increase.
+     * @param newPrincipal The new principal amount
+     * @param newCollateral The new collateral amount
+     * @param newPrice The new liquidation price
+     * @param referencePosition Reference position for cooldown-free price increase (address(0) for normal logic with cooldown)
+     */
+    function adjust(uint256 newPrincipal, uint256 newCollateral, uint256 newPrice, address referencePosition) external onlyOwner {
+        _adjust(newPrincipal, newCollateral, newPrice, referencePosition);
+    }
+
+    /**
+     * @dev Internal implementation of adjust() - handles collateral, principal, and price adjustments.
+     */
+    function _adjust(uint256 newPrincipal, uint256 newCollateral, uint256 newPrice, address referencePosition) internal {
         uint256 colbal = _collateralBalance();
         if (newCollateral > colbal) {
             collateral.transferFrom(msg.sender, address(this), newCollateral - colbal);
@@ -330,7 +350,7 @@ contract Position is Ownable, IPosition, MathUtil {
             _mint(msg.sender, newPrincipal - principal, newCollateral);
         }
         if (newPrice != price) {
-            _adjustPrice(newPrice);
+            _adjustPrice(newPrice, referencePosition);
         }
         emit MintingUpdate(newCollateral, newPrice, newPrincipal);
     }
@@ -341,19 +361,95 @@ contract Position is Ownable, IPosition, MathUtil {
      * Increasing the liquidation price triggers a cooldown period of 3 days, during which minting is suspended.
      */
     function adjustPrice(uint256 newPrice) public onlyOwner {
-        _adjustPrice(newPrice);
+        _adjustPrice(newPrice, address(0));
         emit MintingUpdate(_collateralBalance(), price, principal);
     }
 
-    function _adjustPrice(uint256 newPrice) internal noChallenge alive backed noCooldown {
+    /**
+     * @notice Adjusts the liquidation price without cooldown if a valid reference position is provided.
+     * @dev The reference position must be active (not in cooldown, not expired, not challenged, not closed),
+     *      have the same collateral, and have a price >= newPrice.
+     *      Note: For price decreases (newPrice <= current price), the reference position is ignored
+     *      and only the collateral check is performed, as price decreases don't require cooldown protection.
+     * @param newPrice The new liquidation price
+     * @param referencePosition An active position with the same collateral and at least this price (only used for price increases)
+     */
+    function adjustPriceWithReference(uint256 newPrice, address referencePosition) external onlyOwner {
+        _adjustPrice(newPrice, referencePosition);
+        emit MintingUpdate(_collateralBalance(), price, principal);
+    }
+
+    /**
+     * @dev Unified internal price adjustment logic.
+     * @param newPrice The new liquidation price
+     * @param referencePosition For price increases: address(0) triggers 3-day cooldown,
+     *                          valid reference allows cooldown-free adjustment.
+     *                          For price decreases: ignored (only collateral check performed).
+     *                          Price decreases are allowed even during cooldown since they make the position safer.
+     */
+    function _adjustPrice(uint256 newPrice, address referencePosition) internal noChallenge alive backed {
         if (newPrice > price) {
-            _restrictMinting(3 days);
+            if (block.timestamp <= cooldown) revert Hot();
+            if (referencePosition == address(0)) {
+                _restrictMinting(3 days);
+            } else if (!_isValidPriceReference(referencePosition, newPrice)) {
+                revert InvalidPriceReference();
+            }
         } else {
             _checkCollateral(_collateralBalance(), newPrice);
         }
         _setPrice(newPrice, principal + availableForMinting());
     }
 
+    /**
+     * @notice Checks if a reference position is valid for a cooldown-free price increase.
+     * @param referencePosition The address of the reference position to validate
+     * @param newPrice The new price that should be validated against the reference
+     * @return True if the reference position is valid, false otherwise
+     */
+    function _isValidPriceReference(address referencePosition, uint256 newPrice) internal view returns (bool) {
+        // 1. Reference must be registered in the same hub
+        if (jusd.getPositionParent(referencePosition) != hub) return false;
+
+        IPosition ref = IPosition(referencePosition);
+
+        // 2. Reference must not be this position itself
+        if (referencePosition == address(this)) return false;
+
+        // 3. Same collateral
+        if (address(ref.collateral()) != address(collateral)) return false;
+
+        // 4. Reference must be active (not in cooldown)
+        if (block.timestamp <= ref.cooldown()) return false;
+
+        // 5. Reference must not be expired
+        if (block.timestamp >= ref.expiration()) return false;
+
+        // 6. Reference must not be challenged
+        if (ref.challengedAmount() > 0) return false;
+
+        // 7. Reference must not be closed
+        if (ref.isClosed()) return false;
+
+        // 8. New price must be <= reference price
+        if (newPrice > ref.price()) return false;
+
+        // 9. Reference must have principal > 0 (actively used)
+        if (ref.principal() == 0) return false;
+
+        return true;
+    }
+
+    /**
+     * @notice Checks if a reference position is valid for a cooldown-free price increase.
+     * @param referencePosition The address of the reference position to validate
+     * @param newPrice The new price that should be validated against the reference
+     * @return True if the reference position is valid, false otherwise
+     */
+    function isValidPriceReference(address referencePosition, uint256 newPrice) external view returns (bool) {
+        return _isValidPriceReference(referencePosition, newPrice);
+    }
+
     function _setPrice(uint256 newPrice, uint256 bounds) internal {
         uint256 colBalance = _collateralBalance();
         if (block.timestamp >= start && newPrice > 2 * price) {

package/contracts/MintingHubV2/interface/IPosition.sol

@@ -60,6 +60,14 @@ interface IPosition {
 
     function adjustPrice(uint256 newPrice) external;
 
+    function adjustPriceWithReference(uint256 newPrice, address referencePosition) external;
+
+    function adjust(uint256 newMinted, uint256 newCollateral, uint256 newPrice, address referencePosition) external;
+
+    function isValidPriceReference(address referencePosition, uint256 newPrice) external view returns (bool);
+
+    function isClosed() external view returns (bool);
+
     function mint(address target, uint256 amount) external;
 
     function getDebt() external view returns (uint256);

package/contracts/StartUSD.sol

@@ -6,11 +6,11 @@ import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
 /**
  * @title StartUSD
  * @notice A minimal genesis stablecoin used to bootstrap the JuiceDollar protocol.
- * @dev Mints 10,000 SUSD to the deployer. Used to initialize the protocol with initial
+ * @dev Mints 100,000,000 SUSD to the deployer. Used to initialize the protocol with initial
  * JUSD supply through a StablecoinBridge, which then creates the initial JUICE tokens.
  */
 contract StartUSD is ERC20 {
     constructor() ERC20("StartUSD", "SUSD") {
-        _mint(msg.sender, 10_000 * 10 ** 18);
+        _mint(msg.sender, 100_000_000 * 10 ** 18);
     }
 }

package/dist/index.d.mts

@@ -5209,6 +5209,10 @@ declare const PositionV2ABI: readonly [{
     readonly inputs: readonly [];
     readonly name: "InvalidExpiration";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "InvalidPriceReference";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -5337,6 +5341,28 @@ declare const PositionV2ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "newPrincipal";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newCollateral";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }];
+    readonly name: "adjust";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -5347,6 +5373,20 @@ declare const PositionV2ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }];
+    readonly name: "adjustPriceWithReference";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "assertCloneable";
@@ -5581,6 +5621,24 @@ declare const PositionV2ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }];
+    readonly name: "isValidPriceReference";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "jusd";

package/dist/index.d.ts

@@ -5209,6 +5209,10 @@ declare const PositionV2ABI: readonly [{
     readonly inputs: readonly [];
     readonly name: "InvalidExpiration";
     readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "InvalidPriceReference";
+    readonly type: "error";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -5337,6 +5341,28 @@ declare const PositionV2ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "newPrincipal";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newCollateral";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }];
+    readonly name: "adjust";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [{
         readonly internalType: "uint256";
@@ -5347,6 +5373,20 @@ declare const PositionV2ABI: readonly [{
     readonly outputs: readonly [];
     readonly stateMutability: "nonpayable";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }];
+    readonly name: "adjustPriceWithReference";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "assertCloneable";
@@ -5581,6 +5621,24 @@ declare const PositionV2ABI: readonly [{
     }];
     readonly stateMutability: "view";
     readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "referencePosition";
+        readonly type: "address";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "newPrice";
+        readonly type: "uint256";
+    }];
+    readonly name: "isValidPriceReference";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
 }, {
     readonly inputs: readonly [];
     readonly name: "jusd";

package/dist/index.js

@@ -61,20 +61,17 @@ var ADDRESS = {
     positionFactoryV2: import_viem.zeroAddress
   },
   5115: {
-    // Citrea Testnet - Deployed 2025-11-07
-    juiceDollar: "0x1Dd3057888944ff1f914626aB4BD47Dc8b6285Fe",
-    equity: "0xD82010E94737A4E4C3fc26314326Ff606E2Dcdf4",
-    frontendGateway: "0xe8757e121593bBD9f784F196026259085461aB17",
-    savingsGateway: "0x13531a4E00B36Fdb5f9f9A7c8C85cBc08Fd8EbDb",
-    savingsVaultJUSD: import_viem.zeroAddress,
-    // Not yet deployed
-    mintingHubGateway: "0xFfcD888Eb52F0FdD894fef580370A2FF48d82279",
-    coinLendingGateway: import_viem.zeroAddress,
-    // Not yet deployed
-    bridgeStartUSD: "0xFf862f932eB215A9C4aC8F3d20dd6dAe69DeC6D8",
-    startUSD: "0xf0229A29172E3541F5578dFC02aa024b3Bdb96A1",
-    roller: "0x851FF9f1F5fb7eEf75257aAa0adD2121D6b1Bd49",
-    positionFactoryV2: "0x4cc067EfcD6E6386BA8D6fd31c907Cad6C005318"
+    juiceDollar: "0x258e525B6F9f62195478fe94d14AE20178AB2545",
+    equity: "0xDd965FCdcb4022414204B9BDc5dF949c2761e7Cc",
+    frontendGateway: "0xA9DAD130a5744Bc6DBD7151e184352BFfc57BC87",
+    savingsGateway: "0x71335aa01FB04C234B7CfA72361d7CdC355fE097",
+    savingsVaultJUSD: "0xA049fc273034D44515A81A564c8F43400B3f77B3",
+    mintingHubGateway: "0xF2D5F2F3fA1d048284a9d669805478F8ad677e5a",
+    coinLendingGateway: "0x16c530290662Dc04Dba3040e5e6EBD8e7D3bfe03",
+    bridgeStartUSD: "0x568965b5f8Fa9e6EE56b670e684F85b277545EFE",
+    startUSD: "0xD4A183699d0AbCf774b1ea23CDfC0B4b1d5cB30f",
+    roller: "0x2017C636AA98c7BAAAa68b48195d31Ef5869e37C",
+    positionFactoryV2: "0x171dAe92afc8AC3D581178163a1F993533a94c4B"
   }
 };
 
@@ -6833,6 +6830,11 @@ var PositionV2ABI = [
     name: "InvalidExpiration",
     type: "error"
   },
+  {
+    inputs: [],
+    name: "InvalidPriceReference",
+    type: "error"
+  },
   {
     inputs: [
       {
@@ -6999,6 +7001,34 @@ var PositionV2ABI = [
     stateMutability: "nonpayable",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "uint256",
+        name: "newPrincipal",
+        type: "uint256"
+      },
+      {
+        internalType: "uint256",
+        name: "newCollateral",
+        type: "uint256"
+      },
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      },
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      }
+    ],
+    name: "adjust",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
   {
     inputs: [
       {
@@ -7012,6 +7042,24 @@ var PositionV2ABI = [
     stateMutability: "nonpayable",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      },
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      }
+    ],
+    name: "adjustPriceWithReference",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
   {
     inputs: [],
     name: "assertCloneable",
@@ -7316,6 +7364,30 @@ var PositionV2ABI = [
     stateMutability: "view",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      },
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      }
+    ],
+    name: "isValidPriceReference",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
   {
     inputs: [],
     name: "jusd",

package/dist/index.mjs

@@ -16,20 +16,17 @@ var ADDRESS = {
     positionFactoryV2: zeroAddress
   },
   5115: {
-    // Citrea Testnet - Deployed 2025-11-07
-    juiceDollar: "0x1Dd3057888944ff1f914626aB4BD47Dc8b6285Fe",
-    equity: "0xD82010E94737A4E4C3fc26314326Ff606E2Dcdf4",
-    frontendGateway: "0xe8757e121593bBD9f784F196026259085461aB17",
-    savingsGateway: "0x13531a4E00B36Fdb5f9f9A7c8C85cBc08Fd8EbDb",
-    savingsVaultJUSD: zeroAddress,
-    // Not yet deployed
-    mintingHubGateway: "0xFfcD888Eb52F0FdD894fef580370A2FF48d82279",
-    coinLendingGateway: zeroAddress,
-    // Not yet deployed
-    bridgeStartUSD: "0xFf862f932eB215A9C4aC8F3d20dd6dAe69DeC6D8",
-    startUSD: "0xf0229A29172E3541F5578dFC02aa024b3Bdb96A1",
-    roller: "0x851FF9f1F5fb7eEf75257aAa0adD2121D6b1Bd49",
-    positionFactoryV2: "0x4cc067EfcD6E6386BA8D6fd31c907Cad6C005318"
+    juiceDollar: "0x258e525B6F9f62195478fe94d14AE20178AB2545",
+    equity: "0xDd965FCdcb4022414204B9BDc5dF949c2761e7Cc",
+    frontendGateway: "0xA9DAD130a5744Bc6DBD7151e184352BFfc57BC87",
+    savingsGateway: "0x71335aa01FB04C234B7CfA72361d7CdC355fE097",
+    savingsVaultJUSD: "0xA049fc273034D44515A81A564c8F43400B3f77B3",
+    mintingHubGateway: "0xF2D5F2F3fA1d048284a9d669805478F8ad677e5a",
+    coinLendingGateway: "0x16c530290662Dc04Dba3040e5e6EBD8e7D3bfe03",
+    bridgeStartUSD: "0x568965b5f8Fa9e6EE56b670e684F85b277545EFE",
+    startUSD: "0xD4A183699d0AbCf774b1ea23CDfC0B4b1d5cB30f",
+    roller: "0x2017C636AA98c7BAAAa68b48195d31Ef5869e37C",
+    positionFactoryV2: "0x171dAe92afc8AC3D581178163a1F993533a94c4B"
   }
 };
 
@@ -6788,6 +6785,11 @@ var PositionV2ABI = [
     name: "InvalidExpiration",
     type: "error"
   },
+  {
+    inputs: [],
+    name: "InvalidPriceReference",
+    type: "error"
+  },
   {
     inputs: [
       {
@@ -6954,6 +6956,34 @@ var PositionV2ABI = [
     stateMutability: "nonpayable",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "uint256",
+        name: "newPrincipal",
+        type: "uint256"
+      },
+      {
+        internalType: "uint256",
+        name: "newCollateral",
+        type: "uint256"
+      },
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      },
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      }
+    ],
+    name: "adjust",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
   {
     inputs: [
       {
@@ -6967,6 +6997,24 @@ var PositionV2ABI = [
     stateMutability: "nonpayable",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      },
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      }
+    ],
+    name: "adjustPriceWithReference",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
   {
     inputs: [],
     name: "assertCloneable",
@@ -7271,6 +7319,30 @@ var PositionV2ABI = [
     stateMutability: "view",
     type: "function"
   },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "referencePosition",
+        type: "address"
+      },
+      {
+        internalType: "uint256",
+        name: "newPrice",
+        type: "uint256"
+      }
+    ],
+    name: "isValidPriceReference",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
   {
     inputs: [],
     name: "jusd",

package/exports/abis/MintingHubV2/PositionV2.ts

@@ -132,6 +132,11 @@ export const PositionV2ABI = [
     name: 'InvalidExpiration',
     type: 'error',
   },
+  {
+    inputs: [],
+    name: 'InvalidPriceReference',
+    type: 'error',
+  },
   {
     inputs: [
       {
@@ -298,6 +303,34 @@ export const PositionV2ABI = [
     stateMutability: 'nonpayable',
     type: 'function',
   },
+  {
+    inputs: [
+      {
+        internalType: 'uint256',
+        name: 'newPrincipal',
+        type: 'uint256',
+      },
+      {
+        internalType: 'uint256',
+        name: 'newCollateral',
+        type: 'uint256',
+      },
+      {
+        internalType: 'uint256',
+        name: 'newPrice',
+        type: 'uint256',
+      },
+      {
+        internalType: 'address',
+        name: 'referencePosition',
+        type: 'address',
+      },
+    ],
+    name: 'adjust',
+    outputs: [],
+    stateMutability: 'nonpayable',
+    type: 'function',
+  },
   {
     inputs: [
       {
@@ -311,6 +344,24 @@ export const PositionV2ABI = [
     stateMutability: 'nonpayable',
     type: 'function',
   },
+  {
+    inputs: [
+      {
+        internalType: 'uint256',
+        name: 'newPrice',
+        type: 'uint256',
+      },
+      {
+        internalType: 'address',
+        name: 'referencePosition',
+        type: 'address',
+      },
+    ],
+    name: 'adjustPriceWithReference',
+    outputs: [],
+    stateMutability: 'nonpayable',
+    type: 'function',
+  },
   {
     inputs: [],
     name: 'assertCloneable',
@@ -615,6 +666,30 @@ export const PositionV2ABI = [
     stateMutability: 'view',
     type: 'function',
   },
+  {
+    inputs: [
+      {
+        internalType: 'address',
+        name: 'referencePosition',
+        type: 'address',
+      },
+      {
+        internalType: 'uint256',
+        name: 'newPrice',
+        type: 'uint256',
+      },
+    ],
+    name: 'isValidPriceReference',
+    outputs: [
+      {
+        internalType: 'bool',
+        name: '',
+        type: 'bool',
+      },
+    ],
+    stateMutability: 'view',
+    type: 'function',
+  },
   {
     inputs: [],
     name: 'jusd',

package/exports/address.config.ts

@@ -32,17 +32,16 @@ export const ADDRESS: Record<number, ChainAddress> = {
     positionFactoryV2: zeroAddress,
   },
   5115: {
-    // Citrea Testnet - Deployed 2025-11-07
-    juiceDollar: "0x1Dd3057888944ff1f914626aB4BD47Dc8b6285Fe",
-    equity: "0xD82010E94737A4E4C3fc26314326Ff606E2Dcdf4",
-    frontendGateway: "0xe8757e121593bBD9f784F196026259085461aB17",
-    savingsGateway: "0x13531a4E00B36Fdb5f9f9A7c8C85cBc08Fd8EbDb",
-    savingsVaultJUSD: zeroAddress, // Not yet deployed
-    mintingHubGateway: "0xFfcD888Eb52F0FdD894fef580370A2FF48d82279",
-    coinLendingGateway: zeroAddress, // Not yet deployed
-    bridgeStartUSD: "0xFf862f932eB215A9C4aC8F3d20dd6dAe69DeC6D8",
-    startUSD: "0xf0229A29172E3541F5578dFC02aa024b3Bdb96A1",
-    roller: "0x851FF9f1F5fb7eEf75257aAa0adD2121D6b1Bd49",
-    positionFactoryV2: "0x4cc067EfcD6E6386BA8D6fd31c907Cad6C005318",
+    juiceDollar: "0x258e525B6F9f62195478fe94d14AE20178AB2545",
+    equity: "0xDd965FCdcb4022414204B9BDc5dF949c2761e7Cc",
+    frontendGateway: "0xA9DAD130a5744Bc6DBD7151e184352BFfc57BC87",
+    savingsGateway: "0x71335aa01FB04C234B7CfA72361d7CdC355fE097",
+    savingsVaultJUSD: "0xA049fc273034D44515A81A564c8F43400B3f77B3",
+    mintingHubGateway: "0xF2D5F2F3fA1d048284a9d669805478F8ad677e5a",
+    coinLendingGateway: "0x16c530290662Dc04Dba3040e5e6EBD8e7D3bfe03",
+    bridgeStartUSD: "0x568965b5f8Fa9e6EE56b670e684F85b277545EFE",
+    startUSD: "0xD4A183699d0AbCf774b1ea23CDfC0B4b1d5cB30f",
+    roller: "0x2017C636AA98c7BAAAa68b48195d31Ef5869e37C",
+    positionFactoryV2: "0x171dAe92afc8AC3D581178163a1F993533a94c4B",
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juicedollar/jusd",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "JuiceDollar (JUSD) - Oracle-free, Bitcoin-collateralized stablecoin on Citrea. Decentralized minting with democratic governance.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -19,6 +19,7 @@
     "lint:sol:fix": "prettier --write \"contracts/**/*.sol\"",
     "lint:test:fix": "prettier --write \"test/**/**.test.ts\"",
     "compile": "npx hardhat compile",
+    "prepare": "hardhat compile",
     "wallet": "npx ts-node helper/wallet.info.ts",
     "coverage": "npx hardhat coverage",
     "deploy": "npx hardhat run scripts/deployment/deploy/deployProtocol.ts",