From f046f071da601fc37a06793ef36a53f82cef86ac Mon Sep 17 00:00:00 2001
From: 0xPatrick <patrick@0xpatrick.dev>
Date: Wed, 11 Dec 2024 11:50:29 -0500
Subject: [PATCH] chore: `ChainPolicy` schema

- rename `nobleContractAddress` to `attenuatedCttpBridgeAddress`
- include jsdoc comments for `ChainPolicy` type
- removed `chainType` from `ChainPolicy`. unused and should have been an enum. not needed for OCW currently
---
 .../fast-usdc/snapshots/fast-usdc.test.ts.md  |   2 +-
 .../snapshots/fast-usdc.test.ts.snap          | Bin 2150 -> 2198 bytes
 packages/fast-usdc/src/type-guards.js         |  19 ++++++++----------
 packages/fast-usdc/src/types.ts               |   7 +++++--
 packages/fast-usdc/src/utils/deploy-config.js |  10 +++++----
 5 files changed, 20 insertions(+), 18 deletions(-)

diff --git a/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.md b/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.md
index 4b19508a1d9..f27a41da2c4 100644
--- a/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.md
+++ b/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.md
@@ -17,10 +17,10 @@ Generated by [AVA](https://avajs.dev).
         {
           chainPolicies: {
             Arbitrum: {
+              attenuatedCttpBridgeAddress: '0xe298b93ffB5eA1FB628e0C0D55A43aeaC268e347',
               cctpTokenMessengerAddress: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
               chainId: 42161,
               confirmations: 2,
-              nobleContractAddress: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
             },
           },
           nobleAgoricChannelId: 'channel-21',
diff --git a/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.snap b/packages/boot/test/fast-usdc/snapshots/fast-usdc.test.ts.snap
index 0245ac610536e1cb1eb05b4dcbb3488a31497b0d..4647d12715fa8bbddbe4a9e3641aa8f369ea9e3a 100644
GIT binary patch
literal 2198
zcmV;H2x<30RzV<BZeeh9Xm4~Nb~6eC0Jq1a-=0!s(x(YdVSPUvY*#GFKCd}-WCi8s
zLu`Pw;2(<!00000000BsSZ#<LNf~~syJvSYo4xFsoN($T&E)hF*^lYj%<ODVB$L_8
z87`NL`8q#VV@-F>OlNz##;%&pE-_$~`z0tIc&O(OlZyz#A>t3=L{Ja}PX+Zj&*Owc
z<v{-^h<FGQ>6(x2>6x9mApwK)W9Y8;dEa{L?W*UgsvDKE$L)3T^i3vR>9NiIR{~cu
zVOAJ(%m(*dd&`vE+z^rnw8~uJ(}t*VDX!mi94hHYwU>2FBK(mg(dGbT0qi9cvm{Xr
z0=h*==V{NLJs>F%0y0I&2RcqV1F#O@YcWSH?x=z6#$KXfAJIV)v*f`>v+TK|#+-!;
z74m{`?1eD%Gb(Y_&8@H#682;K7QpWTyaiy9wELQPvV57@lIY#XnVA`oX@p(eN62}C
zZg<mmjk>-H?lJ+gCrqYe+~@PM$BI=RxOS;VeV=(JosKbOw_4`2R?KZ$xvla#b^SKp
zAciXDRRUa(=V|oiNmQQCMe<A*gR(1wW<3m(_!R+OCO}pLzNi7;)nXwNeIbollJBNc
zGQUYBb4pS+jt8z&Wktscm=GPz`!ky?yHY5xELAGUbF65cIG)cISf-R&&E<+mmMEj8
zY`(yjjx5KbKVaLkah|U;{|P1p^Q$cAk8Q0iEoB@lv$|5U3(GkxYZVx+<g7;vg+gvM
zlPlzpWFO5Gim}*}>XUT}tAFnn;`O(=UvYyvl`i*1yZ##UXqkDN|GD5hEHKmEX_lTd
zWsRBX0kbV_`rKirD@=!ZtQyuTTsa}U%6t}3&!oO%s(j`}gV}DywOdQf4Hp~_6!rua
z(!6kPwWOBdLh5{tnQW8R8y+*u%;Q%~*Ylb}1~gozp@*<*tWHf{QE%a*G`snRO#xd-
zrOq*CQcrNR%xU15bsC5o^*q<Fnl|@0n6HL!9=asCNgEADgG+}OI;8O6HYu2@T-D*6
zVEo~(al%)}=7jeQ=7f^UTlMmMml6`M0C*k1zX8k;V16_$7;3pa9$9X?ZSKo}+VU)w
zOj$P~R-@uksakJDTBquC^CAsgTJ~Blzla9hXj@tVlSKa)0d5oEUGcRWqk|;Ta~kl7
z2AqvUlYP*p23*yEXX4OZeb66hz>hTGwKz1@S0GJ|=bu_+unzNi-Sw&Dfijx<wsDu=
zth1nH>UuvO0VK)+^_|$VO>9uF$<!O!O%hfnlgUK<KRllQWG<75MR-adlK<y+$UjN+
z7j)qJI`DISILju9{#PCNyADhmG3aD3bOvOi^PeR8`wU>t07`MUslFZ@1GsDe*W=LL
zJAAco8e`Q>v!W$?X*_3=jrjh0JYU`F`B=Xjvu6t=*;|l_S+ck2d92Euqb>SXVfyMH
z{<p>9k8ejDTC_7n8@4&M87K`>O3+n-dqV&Yv<0BSxo6gy3|w0bmw?2@yCwl&A6o+U
z50HQ`^(R`HtA4)K6@ke&0K5rc7XjW&fD!>J1bBM17)+??cQeA>v&^@f^)d^XbDVnA
zw_Ei7%LpVTYBXR^@j%v;?X4*FOD?H*oCg8FB9!%Dgh*$VwbYiI6O6SWrz4PQ1v$gH
z*EMfNsaToMvIgA}s>-)C;5!=dlhMlZh6cQ;0eYO;Ci<ZJb>JZ#cq9%@^+7+T1E11?
zD{*K)ojt1q-)QseFgi;T{Wm)Bst)`u4xQeC`R*H&LZbAuVhqs=#~7h?U%G>yzj6n@
z&)tFVjq!bxeR8-X;U<axZ3B400Dd|`8<Rx;lL7q20FW5Ii<tpQ4Epa5>Of*_73un(
z8Q(YAw>^8HTaa-5o(ow*^y*Netv#=e)Sd|6?VvuP##}g8GEcdmZn};ux57?Mw#n}e
z&3UM;In=g!)0ZY~9SPY8;hCsKgeOq|@Ie3{0&ot%Cr62pp~S&$1(+h_nYK(!5%R<E
zQB#k94j*+j`=*sh0C_S@rIJK165ufcd^QF&;=nHu;L8MfDF&R3179J)>jX$?y};B+
zfqX~5K&o-wueC-y$mh@iQKjm(!>Z7AcB)itAKF!<V?!bxe!Gz@6>5D*s6iJ%>O#em
zOi1Patkw~FJ=D0LX#nD)p!bo=F&#Le1C`O+_-i`wc^!B@4(&g1y{H2})`8n`s+t<4
zN<I8B6)xyvYb|uz?%$#QJ&v=2N$IgV^JUEaojVnMK=($OJ6oL>{a`w+Sa07%g!P2S
zr5M9GGrqHSKs$If?QxrW?QGLW(~EA|o^S9#F1j{VM{(|XESR?zdEkWmu*Iuu=?xYL
zm-}n!qibo`7TM)_Yb`yumfpsfxbHJNWTcahg4x}M`Q@wv*SL_wU`H|v)@CYY-JXof
z#C)4Ou3uHQM!+RsQtfi{{8odhR^hB)sy999UaE`gTKbwAUi<oRv2%@RrRUNCt8>X>
zb*S;iVo%~d)d>gie_fSpYG$1pFtd_96gkn$r9HM?Lu|Vvww4rckrzj4@lgF;Et#F`
zqlJ`dn&xRP*->)<uYJ6=kc+l0!;k)nxq+ZIO|&5@VtDO12<rNh1$E}QRBlH#X}}^<
zUfwc~wP<3I2X>9AJ%G!76?ns?=EGN9S$i^SdRTRMNUhS(*j&`PI6NOZ&$p#~e%+M|
zmqly1_rhKysMB>O%%*T`lR6vWp{;LY@sWSrwFB*|V;^YO27Eptscedc%%)wi%68t$
z<jVOB%`P3Wm+f4J+SYQx%CoZV<Z^k-S<2^~N}*g?Dzn^5rLt65&gHVpd22b7ZFfdU
z_momxy;wY5I(hoB_HOg`$lYcunIYF4EdUeYSFCiexMe_nQDK2FT_^lP6}L6zWR1Cj
YDL2g;6*VUQw;R&`0xWA<6eJq}0G4z?H~;_u

literal 2150
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

diff --git a/packages/fast-usdc/src/type-guards.js b/packages/fast-usdc/src/type-guards.js
index a645f90bae4..ebc50505267 100644
--- a/packages/fast-usdc/src/type-guards.js
+++ b/packages/fast-usdc/src/type-guards.js
@@ -94,16 +94,13 @@ export const PoolMetricsShape = {
 harden(PoolMetricsShape);
 
 /** @type {TypedPattern<ChainPolicy>} */
-export const ChainPoliciesShape = M.splitRecord(
-  {
-    nobleContractAddress: EvmHashShape,
-    cctpTokenMessengerAddress: EvmHashShape,
-    confirmations: M.number(),
-    chainId: M.number(),
-  },
-  { chainType: M.number() },
-);
-harden(ChainPoliciesShape);
+export const ChainPolicyShape = {
+  attenuatedCttpBridgeAddress: EvmHashShape,
+  cctpTokenMessengerAddress: EvmHashShape,
+  confirmations: M.number(),
+  chainId: M.number(),
+};
+harden(ChainPolicyShape);
 
 /**
  * @type {TypedPattern<FeedPolicy>}
@@ -115,7 +112,7 @@ export const FeedPolicyShape = M.splitRecord(
   {
     nobleDomainId: M.number(),
     nobleAgoricChannelId: M.string(),
-    chainPolicies: M.recordOf(M.string(), ChainPoliciesShape),
+    chainPolicies: M.recordOf(M.string(), ChainPolicyShape),
   },
   { eventFilter: M.string() },
 );
diff --git a/packages/fast-usdc/src/types.ts b/packages/fast-usdc/src/types.ts
index ee9a90efffd..2173b4e42e8 100644
--- a/packages/fast-usdc/src/types.ts
+++ b/packages/fast-usdc/src/types.ts
@@ -58,11 +58,14 @@ export interface PoolMetrics extends PoolStats {
 }
 
 export interface ChainPolicy {
-  nobleContractAddress: EvmHash;
+  /** `msg.sender` of DepositAndBurn to TokenMessenger must be an attenuated wrapper contract that does not contain `replaceDepositForBurn` */
+  attenuatedCttpBridgeAddress: EvmHash;
+  /** @see {@link https://developers.circle.com/stablecoins/evm-smart-contracts} */
   cctpTokenMessengerAddress: EvmHash;
+  /** the number of block confirmations to observe before reporting */
   confirmations: number;
+  /** e.g., `1` for ETH mainnet 42161 for Arbitrum One. @see {@link https://chainlist.org/} */
   chainId: EvmChainID;
-  chainType?: number;
 }
 
 export interface FeedPolicy {
diff --git a/packages/fast-usdc/src/utils/deploy-config.js b/packages/fast-usdc/src/utils/deploy-config.js
index 653d95ff293..7b160a7996c 100644
--- a/packages/fast-usdc/src/utils/deploy-config.js
+++ b/packages/fast-usdc/src/utils/deploy-config.js
@@ -64,11 +64,12 @@ export const configurations = {
       nobleDomainId: 4,
       chainPolicies: {
         Arbitrum: {
+          attenuatedCttpBridgeAddress:
+            '0xe298b93ffB5eA1FB628e0C0D55A43aeaC268e347',
           cctpTokenMessengerAddress:
             '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
           chainId: 42161,
           confirmations: 2,
-          nobleContractAddress: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
         },
       },
     },
@@ -92,11 +93,12 @@ export const configurations = {
       nobleDomainId: 4,
       chainPolicies: {
         Arbitrum: {
+          attenuatedCttpBridgeAddress:
+            '0xe298b93ffB5eA1FB628e0C0D55A43aeaC268e347',
           cctpTokenMessengerAddress:
             '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
           chainId: 42161,
           confirmations: 2,
-          nobleContractAddress: '0x19330d10D9Cc8751218eaf51E8885D058642E08A',
         },
       },
     },
@@ -118,10 +120,10 @@ export const configurations = {
       nobleDomainId: 4,
       chainPolicies: {
         Arbitrum: {
+          attenuatedCttpBridgeAddress: '0xTODO',
           cctpTokenMessengerAddress: '0xTODO',
           chainId: 421614,
           confirmations: 2,
-          nobleContractAddress: '0xTODO',
         },
       },
     },
@@ -140,10 +142,10 @@ export const configurations = {
       nobleDomainId: 4,
       chainPolicies: {
         Arbitrum: {
+          attenuatedCttpBridgeAddress: '0xTODO',
           cctpTokenMessengerAddress: '0xTODO',
           chainId: 421614,
           confirmations: 2,
-          nobleContractAddress: '0xTODO',
         },
       },
     },