script to deploy test receiver (#436)

* script to deploy test receiver

* update readme

* remove comment

* fmt

* fix runtime importing @jest/globals

* add .env to gitignore

* fmt

* Update contracts/scripts/README.md

Co-authored-by: Juan Farber <[email protected]>

* Update contracts/scripts/deployReceiver.ts

Co-authored-by: Juan Farber <[email protected]>

* Update contracts/scripts/deployReceiver.ts

Co-authored-by: Juan Farber <[email protected]>

* Update contracts/scripts/deployReceiver.ts

Co-authored-by: Juan Farber <[email protected]>

* fix router addr instead of offramp addr

* fix routeraddr

---------

Co-authored-by: Juan Farber <[email protected]>

Author: vicentevieytes

.gitignore

@@ -48,3 +48,5 @@ _vendor/
 
 # Binary
 cmd/chainlink-ton/chainlink-ton
+
+.env

contracts/.env_example

@@ -0,0 +1,6 @@
+
+WALLET_MNEMONIC="word1 word2 ... word24"
+WALLET_VERSION="v4R2"   # or v4, v5r1, etc
+# optionally:
+# WALLET_ID="123456"
+# SUBWALLET_NUMBER="0"

contracts/jest.config.ts

@@ -23,6 +23,8 @@ const config: Config = {
   workerThreads: true,
 
   testTimeout: 30000, // Overwrite default 5s timeout
+
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
 }
 
 export default config

contracts/jest.setup.ts

@@ -0,0 +1,4 @@
+import { expect } from '@jest/globals'
+import { tonEquals } from './src/utils'
+
+expect.addEqualityTesters([tonEquals])

contracts/scripts/README.md

@@ -0,0 +1,6 @@
+Run scripts with `yarn blueprint run`, [configure your wallet mnemonic on a .env file](https://github.com/ton-org/blueprint#using-mnemonic-provider)
+
+```
+yarn blueprint run deployReceiver --testnet --mnemonic RouterAddr...
+yarn blueprint run updateReceiverBehavior --testnet --mnemonic ReceiverAddr... RejectAll
+```

contracts/scripts/deployReceiver.ts

@@ -0,0 +1,45 @@
+import { Address, toNano } from '@ton/core'
+import { compile, NetworkProvider } from '@ton/blueprint'
+import { Receiver, ReceiverBehavior } from '../wrappers/ccip/Receiver'
+import { generateRandomContractId } from '../src/utils'
+
+export async function run(provider: NetworkProvider, args: string[]) {
+  const [routerRaw] = args
+
+  if (!routerRaw) {
+    throw new Error(
+      'Usage: yarn blueprint run deployReceiver --<network> --mnemonic <routerAddress>',
+    )
+  }
+
+  const routerAddress = Address.parse(routerRaw)
+
+  const receiverAddress = await deployReceiver(provider, routerAddress)
+
+  console.log('✅ Receiver deployed at:', receiverAddress.toString())
+}
+
+export async function deployReceiver(
+  provider: NetworkProvider,
+  routerAddress: Address,
+): Promise<Address> {
+  const deployer = provider.sender().address!
+  const receiver = provider.open(
+    Receiver.createFromConfig(
+      {
+        id: generateRandomContractId(),
+        behavior: ReceiverBehavior.RejectAll,
+        ownable: {
+          owner: deployer,
+          pendingOwner: null,
+        },
+        authorizedCaller: routerAddress,
+      },
+      await compile('ccip.test.receiver'),
+    ),
+  )
+
+  await receiver.sendDeploy(provider.sender(), toNano('0.5'))
+  await provider.waitForDeploy(receiver.address)
+  return receiver.address
+}

contracts/scripts/updateReceiverBehavior.ts

@@ -0,0 +1,37 @@
+import { Address, toNano } from '@ton/core'
+import { NetworkProvider } from '@ton/blueprint'
+import { Receiver, ReceiverBehavior } from '../wrappers/ccip/Receiver'
+
+export async function run(provider: NetworkProvider, args: string[]) {
+  const [receiverRaw, behaviorRaw] = args
+
+  if (!receiverRaw || !behaviorRaw) {
+    throw new Error(
+      'Usage: yarn blueprint run updateReceiverBehavior --<network> --mnemonic <receiverAddress> <behavior>',
+    )
+  }
+
+  const receiver = Address.parse(receiverRaw)
+
+  // Map string -> enum value
+  const behavior = (ReceiverBehavior as any)[behaviorRaw as keyof typeof ReceiverBehavior]
+
+  if (behavior === undefined) {
+    throw new Error(
+      `Unknown behavior "${behaviorRaw}". Valid values: ${Object.keys(ReceiverBehavior).join(', ')}`,
+    )
+  }
+
+  await updateReceiverBehavior(provider, receiver, behavior)
+
+  console.log(`✅ Updated receiver ${receiver.toString()} behavior to ${behaviorRaw}`)
+}
+
+async function updateReceiverBehavior(
+  provider: NetworkProvider,
+  receiver: Address,
+  behavior: ReceiverBehavior,
+) {
+  const receiverContract = provider.open(Receiver.createFromAddress(receiver))
+  await receiverContract.sendUpdateBehavior(provider.sender(), toNano('0.05'), { behavior })
+}

contracts/src/utils/types.ts

@@ -98,7 +98,7 @@ export function hashSync(data: string): bigint {
   return uint8ArrayToBigInt(sha256_sync(data))
 }
 
-function tonEquals(a, b) {
+export function tonEquals(a, b) {
   if (a instanceof Address) {
     if (!(b instanceof Address)) return false
     return a.equals(b)
@@ -161,9 +161,7 @@ export function generateRandomMockSigners(count: number) {
 }
 
 // Extend expect to support Address and Cell equality
-import { expect } from '@jest/globals'
 import { WalletContractV4 } from '@ton/ton'
-expect.addEqualityTesters([tonEquals])
 
 export function generateRandomContractId(): bigint {
   return BigInt(Math.floor(Math.random() * 0x100000000)) // 2^32