From 290d3146ca99d64a4858c228538eaf2e4e00db84 Mon Sep 17 00:00:00 2001
From: Aidan Reilly <74046732+aireilly@users.noreply.github.com>
Date: Wed, 21 Aug 2024 16:32:44 +0100
Subject: [PATCH] Adding O-RAN API docs for PTP events

Review updates

further updates for Jack

Lisa's comments
---
 _topic_maps/_topic_map.yml                    |  10 +-
 ...ift_PTP_bare-metal_OCP_nodes_0323_4.17.png | Bin 0 -> 80763 bytes
 ...f-about-ptp-and-clock-synchronization.adoc |  13 +-
 ...s-consumer-sidecar-and-http-transport.adoc |  37 ++
 ...ing-ptp-event-producer-with-o-ran-api.adoc |  28 +
 ...tp-fast-event-notifications-framework.adoc |  42 +-
 ...figuring-the-ptp-fast-event-publisher.adoc |  26 +-
 ...-event-notifications-api-reference-v2.adoc | 484 ++++++++++++++++++
 ...st-event-notifications-api-reference.adoc} | 276 +++++-----
 ...migrating-from-amqp-to-http-transport.adoc |   1 +
 .../cnf-monitoring-fast-events-metrics.adoc   |  17 +-
 .../nw-ptp-operator-metrics-reference.adoc    |   7 +-
 .../ptp-cloud-event-proxy-sidecar-api.adoc    |  18 -
 .../ptp-events-consumer-application-v2.adoc   | 108 ++++
 modules/ptp-events-consumer-application.adoc  |  12 +-
 ...-getting-the-current-ptp-clock-status.adoc |  46 --
 ...ference-deployment-and-service-crs-v2.adoc | 108 ++++
 ...-reference-deployment-and-service-crs.adoc |   2 +-
 ...tp-subscribing-consumer-app-to-events.adoc |  91 +---
 ...s-consumer-app-is-receiving-events-v2.adoc |  82 +++
 ...ents-consumer-app-is-receiving-events.adoc |   4 +-
 networking/ptp/about-ptp.adoc                 |   2 +
 networking/ptp/configuring-ptp.adoc           |   6 +-
 ...loud-events-consumer-dev-reference-v2.adoc |  55 ++
 ...p-cloud-events-consumer-dev-reference.adoc |  46 +-
 .../ptp/ptp-events-rest-api-reference-v2.adoc |  29 ++
 .../ptp/ptp-events-rest-api-reference.adoc    |  33 ++
 networking/ptp/using-ptp-events.adoc          |  64 ---
 snippets/ptp-event-config-api-v1.adoc         |  15 +
 snippets/ptp-event-config-api-v2.adoc         |  18 +
 .../ptp-events-rest-api-v1-deprecation.adoc   |   6 +
 31 files changed, 1261 insertions(+), 425 deletions(-)
 create mode 100644 images/319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.17.png
 create mode 100644 modules/cnf-about-ptp-events-consumer-sidecar-and-http-transport.adoc
 create mode 100644 modules/cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api.adoc
 create mode 100644 modules/cnf-fast-event-notifications-api-reference-v2.adoc
 rename modules/{cnf-fast-event-notifications-api-refererence.adoc => cnf-fast-event-notifications-api-reference.adoc} (67%)
 delete mode 100644 modules/ptp-cloud-event-proxy-sidecar-api.adoc
 create mode 100644 modules/ptp-events-consumer-application-v2.adoc
 delete mode 100644 modules/ptp-getting-the-current-ptp-clock-status.adoc
 create mode 100644 modules/ptp-reference-deployment-and-service-crs-v2.adoc
 create mode 100644 modules/ptp-verifying-events-consumer-app-is-receiving-events-v2.adoc
 create mode 100644 networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
 create mode 100644 networking/ptp/ptp-events-rest-api-reference-v2.adoc
 create mode 100644 networking/ptp/ptp-events-rest-api-reference.adoc
 delete mode 100644 networking/ptp/using-ptp-events.adoc
 create mode 100644 snippets/ptp-event-config-api-v1.adoc
 create mode 100644 snippets/ptp-event-config-api-v2.adoc
 create mode 100644 snippets/ptp-events-rest-api-v1-deprecation.adoc

diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
index 06b80b7289..460d4c5725 100644
--- a/_topic_maps/_topic_map.yml
+++ b/_topic_maps/_topic_map.yml
@@ -1371,10 +1371,14 @@ Topics:
     File: about-ptp
   - Name: Configuring PTP hardware
     File: configuring-ptp
-  - Name: Using PTP events
-    File: using-ptp-events
-  - Name: Developing PTP events consumer applications
+  - Name: Developing PTP events consumer applications with the REST API v2
+    File: ptp-cloud-events-consumer-dev-reference-v2
+  - Name: PTP events REST API v2 reference
+    File: ptp-events-rest-api-reference-v2
+  - Name: Developing PTP events consumer applications with the REST API v1
     File: ptp-cloud-events-consumer-dev-reference
+  - Name: PTP events REST API v1 reference
+    File: ptp-events-rest-api-reference
 - Name: External DNS Operator
   Dir: external_dns_operator
   Topics:
diff --git a/images/319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.17.png b/images/319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.17.png
new file mode 100644
index 0000000000000000000000000000000000000000..4843d9c951b0fcffaad49fc30564cf666d32b554
GIT binary patch
literal 80763
zcmeFZcR1F6{5E`*l1kbo5lJdpl_Ikw8mN#^NGN;n-5?T@C^C}lki9Zel9UmWO_IH`
z_kF(A_db5d{pWK$|2)reJNot|*Yz3i_iLQz`8q$B$3<DGb!!;bP$-mjXU|B;Q79{i
zDHN(o8fyHDt)z-Q{<p$h{Hy{Ez8q+@+$j_m%2|n%3O2$0&9)8-<9UlClYvKO+1NB%
zmw#eizFbZsxvfHOd(+ktm91|Tixa*p8kTja_{S;na6I^~clA=-OC8n3ESCqTBe_}b
z+<9<f^}RRuim!h<JR4~4<b3V-wdKn;x!-(LH##yr@`$ZVsP%XtTiB3&ewR6Ii7DeU
zTn+hh3I3@&xccw+_^Ekg8`Zxb9^IuG{_j<vPOg~x?=`<zmOK3Sz1fCkqW^t=+?~Sw
z?|T<U377T%zCS_7TDa=p_bjXa@8KyfjK30Izcv^={@=p6sM`3IYMEF3x7d{aB7J(v
z|M~NsUH^CW|9=)cpLies4qg5?1P}nv?Uxt6``9s3v-&MliLYU!y~syiT3cbuR-Q7g
z!>#p<lf_-5rCp=hi?VE+QVgH7{L8dYyH`w|*b^xiE7+c^8?=V{ZVIQqPl?vy9eX#e
zo@{l~_|!Fe^!#<Bps4Rj>Pe?Px9PrjTc?t)=fBD0-e682ce-x%&7_Kd312vQpTewj
z?>cWxsoy^R@2{0{I5S2m?~d;8SB+~gIQ`jtI-<(XC-A6#0Q-f|*VlRXH)d?5rM7H!
zoQ%Cy5qd6CuC>pcX2o*5>CUH?b*k0}80ij%$j0l}CHDVU0L*BYiB{6=@{#K7?40@O
z$+N{n;uVw7ALG1n#jno}onjKQQaBvgH1O>6=W~<Kq}d}(1YT<$t~a=yUC|{kz-UD^
zcb)eK=jgw@d2_4j!!{kZq`G)q@(Gp~_%k=>kZ>(q&brkx)1a{>p)Su#FV#<keFM##
zMy9{-DpW%Sl40TDxp3rGc}<#bbyLW+%sXD%z^DV&eCDjf6_MHh4librR=F(5MT7p&
z?0nE+?FZEBcfF4A5miZ6GAJlnvts#S8Tk>Lrh)j@m#5cGJBUVB_fU_2ot$>~GwqP;
z*wkm(<dav?<<~m&R9iVNHWpiIG|N<$Vx_-h#orUW(A|J5`Or5Wmy@GXusA<-RP!V4
z)-7B1hsg5l(N^<yj!uvDM2G2NBUDnfJg{SoC6_K;@^z!#@zT6P<Vv31xE!nRBg4jV
z@68?(X-@NYc_SZps-)@oW*E07zI`jaj#>2Dc6Ep3<+o4V{q4te3kM3~HxA|C;CRKv
z|C@<V=aHn(u7qV&)cuy+|L%EW{W4J#my~zuB^{UcZ~69k?|BRCuI{&2XHz)i-*sqN
z*Wt(JAW_GhmsK&+)fV=>jTs4(t<LJz(HH8l=h0<61=rj(_WPCA?AXUh*Ee3LUe|2h
zn(+AXrogBkC!>k}`XGeQ15eMs=8%Fufz(?S-#>V4ZZ=KPtj|ceAUZ8kA-4E7F?UdK
z{^$0BN7~Bw{?)w`o6$t*Tnrm=^>TtCik6n?Z`G3i{P{EX<w%82TjA}TUysjQt^Lub
z85G4?_RV>|&bcSMD^#9s(<LXT{KJ6{zxAZizQ4#z|D>d&YGR=As7BF>%ZiG6b5kQJ
zhF85i&IpN5UQu_v%->{kS1$I+pV84~Ta|#l1+7UJ#O4*koEN6msOI{gQwnBklb)Q5
zta*9bQ*gixmr&IH20ODbRU-B|g|peBT4uKS7|p*>8_e?HGNItiIaUL4>WedVOWBmg
zADY({YM-W6y2({M+|he8&5E%fnm$XHi)+O(AD6zu-!tQV(V-&tIBaCK?)1EqtN3n_
zKcDsl9l7N#l#hJS)r}o|J1UD`uDpBlED43WzRQ_L%{7UtLdU&R>q7qIdT(Ci+Qd&)
zE;J<Uwd06nbB?9F@UEwL8TK}8aqgDmRQvsPc8UKspTUj7EO27P=GxP1W**!*-K@3W
zzn>ElALhE6(H(Hr=#q@gS2bhCzR~G4s{s{}@fvy5hr_g|O10#Qi;HI(TNk1bZI^fo
z=28apCe@JPr74`&B@3E9B2hYgy)9D{^|!)mb1eIsc1_|WVhbZaB;xaii`LrpL_X!S
z{i9{sTchi9g<7jbIoB#-`E3_0ol2%rf^KzG&qxV#-TU=oub-;foqd0Qy>%<2yJQ3c
zamL!h?Qh?7IklMtFJp<Xwlag5(_3%B-u=ZLrn)8Tu5ahQ7PE@k;i72R1viZv`?nQc
z)pOIM>82f$Sl9XtE|d_lx%Tyf18LP;XjVLV`ZW4HPo6^EHFGcQZCZz93IZTIfa_`$
z>XBh%hHlGSTO*q=gh7(J7}*oSi65G^ahDHTc2}Ofa?RA0JF9JZCR2I2@Gc*Yg9pdo
ztzxd(ajPcglHg2tM7r(hO~aPA%2?H!b^J{)kf_>+cdT5#j7v2~VdpV}AGeGh|82;+
zQ|ldGtbQeTAYH#s)_Jaj`KVRDlJzY+>|TeDSfa*zx9r<Cj*5xbdRkr|L#4GIYGF96
z<sKIw-yHHMSxI`2ly?nT{h%O*z^GUqzPNAS<d~f2MjGDQre+v5_YO{Ea-NTn^pY#_
zX1c7ZIv}dZxy_te|B71D73>~)m5?kieNFIj^D!)cZh|%K`$ruDe{6)Y>v+v`e&g>S
zy>`}So8Ln5V;9c-7xv*EXd|puItnF><`0ds+NouN1ujMDe(o6AA1JLi*pz)(#@wew
z@$%*D#jsMXniTExsCqT^dyN}2kkASW3a{egI8cw@^CHvO&X#JKWvY%RT+Iy7R?Zbs
zn~2KH{hTpWZ_8NCcUeyEr3CAxE{^5zd3&!ZZ}5_wocaB4@mxOcM#XrfL2u;F<Wq9g
zs7b(aVY(~mxOo(kd*>FNuFlTvMdP5TxVSilt5?xNx(5p<ZG<04Ml|F*<_bl12n@<j
zFLjl+j32(Q9z1wp*DCNsUWmEG)M{r*3g>uV-GzaM^hV8Ahk-0*BMpsqwE_b4@pa-o
zdd#XqURvdVy=5s{^lqp>4x(X3xdX?z)bp=JMn>8jhWOP+NUi6enwWM_$+Jt(pXoj5
zMSrMhUH|*`H^09=kACoA4HEvi_a2lWZq*z#g?QCmE4|t{{|v)Mc65hvyQAj6rBxk9
ziuLMKB7cr#3CU(`El=buBfD9f?`UrwtaUh+dA?i9Zmddbt4~R@tzDiP;vEGeQtp8D
z<U+YI%hKgiC_kLXawv3Ybq|Vf;Ll*<1m2pcn%g_kXpC~v+~sXimcnQ7gE!r{RjtRO
z!7$gnE5usw-JO+d?!W(ImuELWUN_z)wpgEc)_~RbVu8~<$qXc4x?b%$AP)1Zy;Ji}
zh<NFOxlW#Rn~@tREpabjiaRgPwvHFA<*AwdcxS1$e?y=RWmK)EzH2v9ynVd#)cON~
z(w_+u+LfT1tC-nr^*n%Em7|((t7q{K$A1)qZ?_fJTc>NApmKV8x?s;MKMPz?UyJ=v
zLN)8HE3pda?lU`OIZdR7>3)84fMfrD^Z|rj86VP#$@Z5okc&!&K_JTRoKpezim{}s
z!g;}b>(;FY7`#w_=lgGoRim@LZfH<Jr$@QXn;p!Z8LPf<`P#MDHo}RPec#UtEnk>n
z^E<1GT1Hyj_k^p_7x%Ma*-U>*d<_-3Dq=Tw@o->GbeL0||G_Jys|WGvK6ayH>dm+P
zw+(HD$yCf!-fWvztJ)8wGaR~c?`2iDTEVeE>E4{a#Oedl!7q^+q*~lPS$yM=<M6vx
zDp@AsoMn&yLm5>+k~NRojp^XG)(;ovXZ!dIro9jnf*}EH2q)}&f>N@0-}eMRAWXwP
zKiTNo$n)D}p7EZ1cl{!YGO`-rZ0$DA%CVkmvN1Z?J+$0!ahK!CYB|o0l&sU+{vU$T
zpc%d`iPbY|3|8WdvJvJ+Zp`Kw(1_ulw{G7akK8IZ6`Bl3nX$FCwd)SQZ&7u6`vJew
zn2Zd?0Bzve(!OyHgmzSvq?<<f$DPJCA=WJi8Z-KYtvI(;Yd=+u5*m6d?|Vk#=+UDO
zN;=4?Viv2z78GuUSOx&*<d<|I=`DL>qkBn%(74YO)!VBF?2CB8PT>z$tG1>l=FOXn
zSJZ4HXC?*?mZjw1ANsfACOR)%=_+Y543}yr7W~e;7g(;w48zXJ*}ionn?3H?jrT^9
z<`8tuFbGKu492qIBHO0e%|D~%4s6}Ft@rk-U6nDHBF4ySb$<3g$L@zVk4wHwz3y9g
zRfJ`Ka!F43Tshu|?caLkTDYe7aY@o8^QV5UMUJ59o!u8=@tA<I`qW$TX=xTo6}xx&
z^hJx!$I^+-nS2dCE<cn%o0wrx&)S%wP4Bj5?b@SSpEh_g96d)xO?#2U|K+NGB)sz8
z!>`Zzhe8FH|3Km3Nt#@2nZ?z3NW5&Jh#lNO^NH`PAoF>)O_s~&IN$Sbp{3q?7WZm?
z_1CYiuK1XkGZ}`t;R`J*mM^o-Q$w&|A=7oLibCQ`I%2D-oQ*5qVaJ9h4<aC+8|PnQ
z_wxl#1SCb-)>00ze}DDgvdVx+e9|B#f4WunN`~Q39o=NVj8&g~>Wk!#XQZ<K67V)?
z6m2{7kMj2K;IeRG3@Fv2%i{9t5SVRBXstBuHvO014$c5l{|-(0|Dek7C^LH>E}u>m
z_(L=->7=@TV+KH`LE}Ps*GgzEQBnh|C||K=6bhd^Rum|;Lx6*ar|z@=!SUKF>al5Q
z3Rg1>$a-tgV>_p(r+a@SM|cbTq!}M-Rd3F<z5?KgBg(}pn2T-2srsqXnJK@hiB9u|
zWOVq&Gw8?WzrR#1&Q&bxls?|8f+8(ytq9cp@+Iqdch#wVVGb$ff_<Fh{q^!a7D2^~
z=woy*C#YPSZWy$@t=Anqiz{s+@TgR441GbrAx)Q5AJoe^C+7&B2-)arz1I9Z0yaqz
z>}|=*{W&7=^a|MJFB&~D$|n&bA-zyTYV6&+mlVI7UxW6ZT>_Ds1tn>m=TU%wBy+%G
z##6)Qr5`_$jec&>g4@v%ChwP7dOscF)<a?pwL+)p-fG-N9;@%CWn3**{^ueQgymw3
z4$Zb*A*9N)`s$>NAi^qnYn&*L8i|_aQpQV*>M8U5m<$0_cn|I<->(F#iq^p(>W~#B
z9r*I+&l}s!aNgEE<h+jLyoLTig|YI{y%~*0e&BU=v(2qT`KViWSFQgJ8d;NJcy+H|
z>ChYr=@Zz`Ra9j4Sq8f81@*sk&i{E@pup}ot+vf%sYi7_kso_nFn1ae5h(rJ-rfL<
zduk&#jgj$7>%v54CjTTGjx!3Lsgior%W1?@Jq9$<sbJCG(E*SksbE0`6%!@m0RJ(p
z@D$yp*=2?A-d8tm#&v%!1J?2@)d6p7c%$*&`un7XI*3ZB&Ck^+4;R`^vXlu-8a_n=
zZ`F2kp>(E*5#xgS3~Wl|8Mbc*qr5Wmz>w=jr(OVD2=Ds5g+!|4(i@zFmQze<MwieM
zsf%o-ybtFYAS$9@oQ}AJKgAs*^9=j8tm*N)AX)_gxn+&(gg!0KS(6m2SJ0mvtMEBt
z5ghVysaC|tSBNsl*@eN2kVDM=A<i_DcJY;W-$^n9B5v_10U74A8NME3UVfZ|n_E#?
zIdHIG(FqGKIS>Ujnqk;S$c1in2s^1QvJp#p)y$+b@D%k@Pfw5U#s?Zzv(mlTXY@E`
zr>XEzhd-s%nVsR}+<Tx;v~Bn;;H_rcxmEjcpyW^?SRv9(u;bwo()U74idGNafNCc#
zA0=I%v{DHG;%BjEIyfAY<5<->woP8Uh>DUc^r*r37E*0~cCxM}R=ze_Q);p!N>{J9
zCf2Jr{sLCdUTQ6*2)avuK{jFbBz=4?ux(-xvU(lrG@~10_W6M2Hoe(KaVa70fy9J_
zT96g(px;hDIEBli`HOUQ#lwLL_vx6%K5V{FvwA2sOuv686=M92H3?P5mw+(~^Fz-1
zAbe0GyhK|v4AH4_784T_jZ(6~1y-)z_9^8xRRa?ctIMM0i}Wxy<$y?_U8!BR68P^`
zn&y?o+a&u%{;thL=TmhKztaA?<S5-ZG;i~+@>=CvA(8t+ZC;lC)`q?Wyo0Pt-n<q$
z?!kCw;8tS>02L9L$o)Kig;RD9WVVX7*^)>NB|5MP%|R}%<{?#CfDa-dIM0<hcYE=-
zT;yXgOtD1^0@soO3gi5Vr49OYyT%DCTQEOhY*~Bx%Gt-{lx5tx(%>qqgn5vuKaMO#
zvIc5p{gCFm_mv>}xU`~n6F=?@a4`@g(44QVbmS8IjR&sC%SWu`d3$j)yYwTgrlIa2
z{luyVTMurbyT9H>jV$M_mfxWilQ%Row1H_qsfMXGP3(NE*>@r*!0G8)&PJ;(ypis$
zk2FTs(ig6mDl&VL{M>$9;pAOQg~1<T4Hdk!03JF&-e?f<NV*y&J*Ow?`Pg9Y5C<b2
z|Jn5pmu5TJ7Sxty-v(WBc~Mb0RmU-2JM-jM#3Rb^`|C5}Dpx`k_e(h^xz4$LEKrMm
zt9|v!*^=k>f|N?WZ{F;os;}M^JMH}@v)OK0_5(`=qx!H0o<Qk1kiZ~8%Q#>Jf7xgv
zbIgw?IfL-aac=X|RvxUo8W5?($-X3-{fIHadrF2U*L>Om8Ij6noo?046Va=_k7&=z
zq`k+Q`}gcu(2sSM`dsXFG^)LO^yunXc6M#056h;O4KqC6>u8_C#iPtlx9oL<ne-lg
zu@Y0QpeUjZzNZsH`98yD@yl0AZ)U6qT3L^U3Sk01JB}GV3w4}OcKlPi&kp}>rCGrs
zDxz1=^se<FOEe_0b#47WL|A?JM&<$-n(CA8ogP`;*0zn-&2n*Q?O4z6#k_0Bp9*;I
z30x+VofTm>Zk(j>_%x%--K&+e1w!WwR6?HUcDpn@UAAiN_e<H4$?0K+jSnPPd%q_<
zpG}552p#06Pl?4)iz;cGNMmH_PR2I**-kpL7eoQ2ZLDg$Q6M|Oq`+4kc8Ibn(?lR<
za>k-=&Q|XIq@<%5Iv(gktRHn+b-Re;xe=l5g(tax@{hHei#+~1bcFGal2qrt`Pg|V
z5$F<9QZ-K5cMGnZ7z7_>IN)owMdtXHPzs%$cip9=7O79k=1I4`wUzZCq&-l{ymFb7
z>-owRF3c3874D~Y^u_$H`_WK=Y91on7Z;x>C%~9EsgHW>G@0AlgY198_BBN4%4D;3
z7=nB28dnBkek^4XmNFAdNilK%taZ4zE-4K3^@%il=ZH;^{kcR4t9yKe<yNj-3AX!H
z1m(!(u9~L4*n3{B#thMgDb0F&nt9D+rH}wY<d)s+KxQrUF3IK(0S)UZ6P(tHy%b8D
zJ;JLt&)%Bgg;<4Nmyal|qG1*D)|yt=YD;)&*X=y^`kg1irTxtd-<{B1e9ydUSxgBl
z`|QNIfrc;6JA#xKO#)r-LrL}z3rj+?P+q&8TY;CpX($;I*tzrP$ARn5lT_bFps!>^
z$+_t2-fxkfAWm@>f_bgx=oy8Jx}O_(%KFB^gtZ9<VbjGoUW0*u>n$cxg}XWZ&-Fkm
ztl4})I2^QOKL4yTWR!<Hj*R{CyKqj(F3L?jd|t224>3E_6CIEG7MGCFoHUK=ziusa
zc~%?rNhVZS*^gc3vDJ#1@QX2*gnDA<Dc6T|!m0iqpNQasLvKg7cot9C2OF#n3E_!u
zVMg3TCa8XPNRuurfdJZGy*ON~DI+AGOlkvzK1Ncx`2Y4`ychykY>q|GxBjPG`#=Q2
z?|W<Gw|fd;lZGe+AY3CjM&JYBIe~5b%@%&&dMr|#g*kWm=nuEO%bDqo_m^gWu8k^3
z5wk!UGciHrQ79nxIc;~=^4X1b-|P_yl8q)SzIrozjCNT-3TK~v7`jVg_#JF9-7eBb
zPGlIKf6Oi$9Mk^(J_s5CDP<|Z?c|>zJsmwOrbsq-2e~HUC2W<ZxliHb$=d`$y}P^0
znI|_H0-izRcdpE)mutDRPE_fP2{}vSO&1APxkK=776dk^!AA`n_(+?8P!5zkExYUB
zHqQe<4-2zHbpXH#60B7QB1%A3bf*cFn<b|^!Q>$!jt)_)zVK&zv&s8)C^E@PuS>Tn
z1!%_tm{F~wtC7DT5=kn&heT1{lbtwoD>FfKhUEUP^Fz4={>p4J^ITY%Ea=PX@Rmnk
z<=oadRICV%Sw_Zd&6+h99bWu;A0O^u5VVNV)7P(e1Y)mz7&A{{v9`s~1`v-Q921a-
zC~HK1Yq9NO5*ht+gedWN0~!z_8TG$J-ui+|hX4{Xg|kd`%(Ca(X@~(iICO+so?W)5
zI4+M*j9lIl(7m3t1iO67MQ05{?0REWax7v+XS(-rDZM$Nt*ssR`n7_krDaHn!tE0$
zpsXl>$JIh~A)^1O`*fGP%0mEdvov;KBfXbkyf~T2PLyUCLLAuP7LFb2d#33Pv6L_k
zh)TVxAJA)K@n&FW=zJjCNCCs|U08M(N0O{fC&?igzAWLq$<~3!%q!8dArp2xjtUVC
znNAjaQ#nWWrqJnpbTu;dtH?V1!eKp@t8KPRx3CUBEq%ER?f8E<IR3?p-en@dS<u?r
zByZaJGnmqL|5GDiZzZprM*oPpcL(3hGe@uFXwAtnrFB4mSb7b5z&YS-myc9tw+VRf
z^Vguq{b8t)9j(CQQ$olx{zes&W?w&bivjiRdd6r@bao%>d)}rTxyOJqkXfJ`W1+^1
zx2wlss?}Sc8V$ykT3*{X{<|qSsQO*XE+iWnR4m`+Q^NJrs#C!G>i$>I+p2ZXKGqF7
zER*`q$5#YsY}z5;j>@6L^w)?DI%cKM11!v6F92i$&=wQlzHvKrMi3fc8EBm0XkA21
z1D8Y8XBhI^<Y$-njeo`;J{hR5r*fXnhaaIm)mN8P7bWvN&0*SX9izZSDJIJ&v#HMx
zV)Ow$<xgi>y2g8I%sqO8&C7jThm0qRIS?P_F~-f1f}Ten1C&Pc0Oq3Za~wEOwR&Ih
z3j}8@q`Epa`vf9PlGctv%_~SLvmr@`Ceoq~$;dZm8XE^3?|gYzTZGcqcG_kAuPn^u
zT-R>z#Vkh-<$Pc?!|)&@o&KjsyGe;ufNq8^1i7Qn*m?G9UP%qV8y1(zx+xrze)sR^
z#^0Z+JH?)0x!Bc*HmX4n{Om{ADFNc^8cs8>aaB-Ojz#{c4CPIRe*XL!QZZ;@4H{C2
z(@YP+?S!gIvrl$#c5d@2i7?Kemc&hwEJ81|z$`+(aGvs47T;<7_7XI&i^99=ewF$`
zT6q*a>$D0gA4=&=^N>?Cr1L%A0^-pjRzY{(v0N!aLY$IC`_NCyivlO)pr_>k^170w
z79?Q$Qo4Gsg?~Fiuk|UXF;hxce617?k&y6B!QPmNG{~P^Drsj<pFYjO#Z?P|E8;fQ
zDyL|T>6Y(&s7FZd*4bdQs&{FKreQ>rSuivKZS6?WsWz(9tQ&Qu+VYRQ=jFRq&PZma
ze)}$b|Kz&|liVo5l75+Eg-Hns{&jt|Wc@(iPPCgSd3V&*-@ZZb23?b=n4a7@XRMn{
z?>Bl!h~l@N+j+i!<!^n>lRs5t819#Tqj(L`E6I42><47vU1PhQfRw@(#`clIh9V6W
zPxVz*gcR2B1ghWV%a@6ex5=Y_L@)67O)xHfeL}72?gNqlaUkWt7V*;Jl_HCCqcg+r
z*Keh}?++aTtfKd&C-=9ucX$2Iu;owMLXUvRn%Svg)n$(oR$Jig{54EW9nv=$K>H27
zJza)X3eY}U7Hn3#lyAd7GuN1G;FU?0ZTpRR?0JzRfe+DC#KRvUD#kFCQk<U|Cyd>y
zw?l{C?asUFAss0vr^|QebqIi64|eQu+wIe}IA|SmhOKFX6I2ZnYesKJBr)x7{>?;7
zoo>-1r)t~jk6-!y9rrcL?t?JQCj&J-Z~Xh!h7@hjP`lm(=|;^e=-`;T4^8Hp%SOtX
zF_z3f(^j_U+LWi3WUp+%?q}-LI<B9xQZZv+7Bt(|p(`Bzahr3VNA;+Q2Z`LT&p4%w
z2mn?B^A6BHu*qZpmNf_HX+LKeBF6=DL#zkQdj!0NDrQ2@pX$oyANT4Qo&GgBYu)D&
zD&pK=dcf4NtAUqxGT26V7e)t|Hb1Wj-IW>pF=;3ng@wcaF@(I)(TlA+CDz#{^b1G#
z>+{YYt)CU_FAFVyUq0I0*m3MvdP=mp@4Rx$bQgL@+eM^N8WzA283Q5safblfETj^<
z(XaeO+8nf!*6hogS1s#Txe`^ai!hYL#58RIq(isRWf`fFH-IFQj>yOZ9X4M}@5|Bb
zO45IDR0b;a<nd@K<vu>G1d|tCImx51hejB3cTrsC(PtR7u!#g}grB<4;d=%?h93Vb
zYE=Zjond>4K~~<vOdlE8)nL?-x!no5`|7M;no+YLLI~3_H8Q>1`2!;lCaWJBmTUYm
z(LkE%K@ve<!abnZk!*zyA8~R2tH2|-^!k4!f3B!Vl4l8uiiL{YY*xmF)_4UYWDfst
zkd&fH;vjP`LVZAujY4^ggQa3-ZnR>&?e6;Cg2mZ_W`26YyvtHJaTzUn_N3+&KiCR^
zptmyouAo(a*40G^lp|EfKYz^p0|Gd9`NTWUPLOp1Yv0*sC%g+vQ#=apV={*%We2UM
z7POSqHp_vA%V+^;`M7-2w*ic`8#54@5xYd}vW%s%@tBm!LP>*SZnQDSan_3L9Izib
zKb#+X;n_f6Y0Nlx?pzuffI5g00s20Z)iZ-etAg$8Lb~!BUexf*hKV|+p;<U$lET5s
zS>r3Ut7ltMtHY?5VuA_|QX7ATC*82|d$R}TTSztx-7&CEx9n3yd*KihQ-_k*+mxM}
zs}nP1Iy*5CkK0X9Nk8|vhP)B;%n_TnRUJcfL2FkmCpUrxMIhJaS{tL7=mIehP9|T?
zG#YedWSCJYg-D2Yt&(jPc_aCmp!MMExw$#&t$n$n_t6)}2O6(naC*_!HXHIi;O(WM
zj$>o#a;+67Ca%$<3py1zhmB%pF%>>)mq&&({|pi+roe3^iAT$Y2yVWtpzzBr-z%Xb
zh5vAKSo)VlA{xZSrQxo~xDTrelqIjG7HZHKph1t>S3{0vyke4C0w%1aI}=I?IULuB
z7ofeS9F@T^4*Qu|ay)k9c;CY7tyWef)Ga4&zg|VT?o8%{JFuA8S`6yM2uH_cABArm
z11Nb63K6L44kNCKSwGj1*;~U#1I$f(!td`gv;UrnRU|D5rxUU|9Qazk@<&DjlH=rE
z>TG`V&t+xRU=Bn9fZ$1b(N2CNvW?37q}RcuGmu_KIuX_Ycu>`8x)UR&T;LJNyB0N<
zq;w%%Fz_1%Z{t*Yfn$>V`10%!156`0uq9M!{jvZqP(IQ~w(+RFc3v38KwOT{*pJ>!
z@duOMerrA+vhF6c?XQibX^>3f@RtKU@D`oXnFrp!(wgsxDISIp<37%Fr`C(jy<x-X
zPWD@RomzZfQi0k*#n+W&1SG}msNlJc>)U9B*ph{*<D(Zg<*{L-Ue!xihzk)T9VG<3
z`)SbI!O$@N?L1GmkOEr|%sSuT0g1<G%474sUd$)6Y2Q~OlPnhJC-oQRrh%aW4fU#{
zyd)pehm%wObx0Uj3NvF^CD>Xv(=Y6;K|fP^!Re(ZPyP?bQ|$D#y&#O=;ev^dJpYso
zNUxkd>tWESSP?2>Ss^mn4NQ$ekAh&xcf2F!xcP4~6l%yYe2#5`rGcdCr3lHMx`Kst
zjFaHa37PhxKP3KC)hf`aVBRW0El=ffP3o-+&9Kuj95YagD5=moj2UYR=lS)*!!Bxe
zJ$ntCb1tJzlrTHLZOAlE>Zy({%P?eenraU^r0E9Qv3uZ$Z|kGF2Ucl!XZlksh_eFb
zf*MuYhYUwQH@CMu8x?byG6_LpAfsWFY<6(bbqstlEhUEC`g><bjT$p{ISij9)(p$?
z)45gyzecB>F7iKwTB!5TAZgmV#kM5D(+OMNhXt<YZ*_<`s{g&4EI1}!&6I*<%WGHw
z<TOKiKz*Y_!TiKkRny|Fq)~zrl3p2N^V0*PGMEYMFjGA0IAcNT7TO-h17uoDf(Yw`
zX;U9I#wg|JSCPr42$cWimgB`Yk|k@CauY2l(iMNCr~B6R8IEO_Ctlro^%irt9Z1f0
z7(q5PWN($Uy5eAHn9z8GE!X_`PRdQ|wjss_pb#8DFnlO+z9%)s$3HLFq&iB*$n>#c
zfm|4zV|9kM-_TRY^`d_pW<nCEfwx1|d48NwI+O%bJ`k=KA^iuiWvV`C9a`!=SV#UX
zYMDkMgIOJPhOPOk9VI^2)(WlYBSh$G=56JrCB>~g_&Cw@qhv#tP-Vl$wwuNuNG)!5
z82ze}e8Y7Kt($u`6EPM|Gw<bYp~dOZu0ApZPOT7)M}lK84ck~l-o490-0jkAoBj?*
zVHqHon3&VcL29j2K`R$496@meC!c@HT}u>cL@o7K`P?+chT3wj$Jh<jOfrciqg@iF
zB!1rWlKBc5IFRCV%%~{_E)@tMWO$6tP7SpmJWe`22sCN-+hDIb!P2I7IH**M)Jl=z
zLMk-boPmtSrt{~kd(sg1`3p1ps^(vhk`Q3^b;n8JTZwI*`^`@V{g|US#f+qKy)c3k
zP-K3rdN49CK)VM-iwFwByDo&BH(vK1W{!1E321SEgsrOduoQq;kp@K^jpVuuS_>-j
z!|F#jtZ^mws`)<kMYGmtXCmds^Cb&V->C}}Q+%BJ5;BP<X{7(EKYKqX=Mxm_fKWnU
zvspIKbl+VsdJ!3oZ6>*Oo;zDY-ErK%#bH$D>^BTOV`06^EI0Lv?U<Py;yG%@mC93}
zoO0CAO2!6Er1ygJj9;#N3ok7i3zu?=1fdle`y!X?e(49z{C*-*;1#QGEt<Jb`Je>=
zM~hXE*YUdggPRzRT&U)It|daD%-)3!>yu5M8d3JZ=dA6giLoy(CdR}w!(htsg>-cd
z$v8;w;+UcH$&iu(@ct5O3dw+)mj1=hpFagp!|4Xgme==0)xH*+So_IABi`IppdbK+
z7|jyzhAh(v+$3N???Zpb(G!okvwv;Elt2&WCh!ts5ko%5!9S#UE7UeB>O$C{TNa|~
zTb5}@4NL=hW8co(;g-|%YB^+r_|E!>Eo4FHxH?6>d>Qdzl1U!)ZqQrkJC~ufA1N0&
z1xJzsA4BbM`+FF{^vTOG$jZSDxvkqd_W59v4j^L=s?Je(P4Xrh^ohq}@7Yssv{eLu
zp^!t1>T5JEs3npTAPC@9JOm5D+5S}Uhq2!HBy@&zB-H08Ta)hZvir2|`Q)*R{+-9{
z^&&dP?V9abv?_G5A(2nj;y`SBO814;fEI&}5SLc>!z1OD#AZP(jY)YEK^SbOfe$&t
z(MoJ3#G9m_m@Vn=?=OfXugNr4hYUw3z|2fvQgi%)g;B9Z`8@kcE9N@*I#W{Qy270E
ziBw72BS9VreQZcPsUDgiAL<TI5w9KTVZ;DBSZ)Wu$n`=B5pjTMDrbiZl5B+4q8IJ4
z8^kb2ou^2UC)i}}Q2tfmBO>ezFn-5vye1M3?%I00%j{#3^-;PU+dN~P7Z=Ed5?D+I
zf0*68diBAv336IY-8meSw5VHQj*2L{fznYe=8$?!VxUkFbl-f?4<n{Hqvo6*((y>_
zV?cy$Rw{eSQ@2ryu{}|pLB50-0gVRgE7QM#g-!|%g_M+KJa>ShZwxdK`vWLUln7}5
z)woAvLM@|%%^t`Kk9=TPubzW(5?Wh}p{!8mB|t9OQ*~>`S56@(h$RA>$sk;TcAx~t
zAp>>gA2k3{#xf}Gi}~7eF9sV9J7uCQE`+^aqi=FH-D;qr+3KE_b>Kbm-Sabb1&YM3
zv4+7d9MP}9(K(o3KKSQ{rIdKac8C32%#t?57!N{JK~sx{oeetkWfhe;(~gfsL`K&o
zL>Pm`DELQCH<(659Mb&Q-JqXz84a%RHkD=R-ls9IUP**G{P76jQCI8wtpExLBQx<9
z*MPnvKrmXvj$!c%K#Pch6$sM4!Ud=3neGaM!KxPL)m9FW6=+`pD;ycm2Z=f7v&ABi
zb9&?AAt)n_ewT;D7kh5cb!~leK%UGq&wi_tVop$>@4bQnN05+pBF>+PoV80D{Q{BE
z@T&9Fd*(6BMYEq~4>}A=dNal%Y8vO25dSYu-nD?PPx1#8h5$V_qWlH%YTO~wNYbqO
zf|w<bR5Qv%Zr>vEu+C#&XpA?L&}UOdkOnWt<8ox#!O}qX$1&Oao*lOb#t@)@@1#|O
z;ovCxxEG9|@7hPYzoPaj03E?%KoqGRa6XP(5P>0*uu3+VgdKAxTkM-{wT!iDE9*WZ
zS;lbCUVy$U`?o+mBfmYWSF``D9I7)BO;b`*sOPU~SDXTl90v!BhYO3`G^+kT_c_6M
zP_ZsSC%vnFkibcoWmLVwNsb{HQo5Wv%d(*oxlbkxxmPxZK{k5)YH@OLA&d|Vpb=tF
zgI48@La#nV{mQY{6p&XwUNNCbb0R$eg1{9E7>|xk*=i+8H)jtDElhQc!^oTMIHc}0
ztxe=$!nrniNcbh{f_>}i_85)AOHTOWq<unlWqMHy->++7w!Z`I07!QVR{%rlfECN+
zAkaUu6s~fjq&Vi5c<qb^z{Paqd+x#T0|MR=3LKI7j<dbi1+yW*t;tt+g8@RQCPvEo
zjDd`gu@KRD>0gijz6&k^-3SWe&xu3Eb&0BZKFzW6`w)@nPJ|W<b_JUgat|3SCFL;K
zs2;QuOpFJ=I;z_b9ECGBtRfmKaZZTa;~IJ_s`PJfL*)SCXC}-PXlAh7t6%mp__)Ya
z+g+pZAg<r3=H=8c>!%0i7_E)2KmtmK76~I{iD?bU-MSrzB~U#<Ye+e(O}NVM|Ky1d
z_#xb;<{@v=^KBX2cH^X|?R`Y6;x8Pkj;=5YH=O8ohYAOj;Uqj8jDbGL;^m7MU!Xt>
z&a*;YftTQBd2lQ^IVgxBS$H^&qwd^UPOzR(i?!3dR%4C<K$)wnD;W`?3LhN!alHE3
zNNQ`H*G~SN(R>U?6qJ-=K>b0A(hcg(GQ0ACW^n(BCzJePVK;0@E1eHrw@X-w^fB~S
z05uqI(06BpbZJmG@NS%O^7nO^YQMoj2P#a=w^&%>m(m^9k3>j;xvRk5>>#Rsw;Z#C
z!tf8!Heh?Zbo#U_+5<?zF2b2$DgNe7Iet|$e}1Adr$434Dn4PSN(s^V%1!OBmc3R^
zm8{Z9dnc5Yr)C^t_dSKvYnO-$?v8LHnA}~rtHq$$wJ2mBsN<{85X^<Ps}2n7lw`?}
zqxj>gTX5gjgNl4Mp_rD(rn>1r7{~a58o>F{*+{vZxj$u=;8F+u&y|`ocETKXAxyNl
zF*E6KptPUsBpj6@_7gQw?*_LWgdPzhX!#8lr3OoGXB-^F^_F@a!z+@AMy*9;?*BTq
z-0W_b!TD!I@J0K+EWj90(qU>ZIS6Gdb3Ymmxb!z!p^LyTn65Uif<&IlB8^GkU(qB6
zCf|Jz%j1TcT;FRDRzm#U;8TCcOGJeQMTKdlTl9WCzi>*fT8gXAM6gy@a9&qoV(;_l
z4uRgPi2GQW-gU#d7CkAAO7$%x_2%i(K0|Za1|tQAjmK0S$7{*c5sj&GLJxY2io`QR
z<Q=VcId?5QS6(FuzkPi5sB@jTU@nzdqmaU^O@fwKlxqI1`i{v-w>RD$S-{T3Mt*{Y
zr7@#9el^3aN~w4Ds0hb|6*rJ2-PS1GUV>Y$8s~LVSHi|XEGSp^fSH4OL4hFNSO~FJ
z*4jg_cUv|kPGkhsrynzPHyE1kKU6<^LOaQ&yu8Ac@ieP1x@Ldr?IrS~<BnZ42x+af
zz1h|9q;DBTXa91CHWp2^65$bv5UU1V%c4<f_73V98CYdv;LphU`QRXIRecXbq}lt{
z4OxeF1>Opch4)JiSU$s0|K|q}On)jX!%sE0_*MvyKHO#Be+ZWdpCXZ2_63`W=bbh_
z9B6TB0YeFt<O;4}QVqzE03t2nHM3JoyeCA<`YEjIE0^DP%-Hdny3~2POdXB@l3}E`
zVh{lJ;K<D{l~@+lp=6=3gVlV^FRMC6x`7+4?S%tSjff27CHItDH4f?#ES)3}aTBwg
zG^zY+@;khRCK{*;VvVjb;1LP{us*<_D?me+q?jThK*&L>t87TuA1|a@ACr<|<|AZo
z6*8NcRR8fI@tp&JLcmhQgHD()5C^j*NZLU>7<Bu@^~}0hjN~B<<UYTpp5%{kARrGJ
z<W!(e`bd%M+M{S+=w%HJ4T7H0ZlAdO0j80@fF?wzM~#Cb{&{FJ9#a9RipI!&_$$ev
z4s=>UQSo=Er|%xAoUWJoVFyVwI*DfV)^;?_p#Ctz0rzSNi-J=@fviXlRJgyMZ8DF@
zT{*Qbp~EVneKI4U2SJU(pJqGyn_A>)zaZDu3V<9)4&7k=ic2!pcRa#FhAlApLEPf&
z3A$<A=NEOYuYZX8iDO6~ZVdDL)JvmZ5;q6wfqZxo>GfVp`*h3lv8Wr38M)^p4i#f6
zN`#}>_{5xZ#A<-sgtl%`ul-cFyD}W=AZ9UvqO<)+0F&tWTWli0$I=_=%;8hRlVtHg
zM<`2#D~!RCP5h%Ux5B%i004TtD;S7n<_sin5^W%H;eN7$X9@TvOqXy5K<EXdJkGw3
z5gP?n)dZAhJR5*i!}94(4Y!kNL{ql;B>l5R=ZQffjyQ9}ol{3cb_B7!yt9{s^+gQ5
zfsKL3Sq0hviOpX5pFNVDJ?uCSeQdemWy~k(r|Fr;|L~IU*5e$>;WQ^Xmz~<Oa&1V@
zkyhrU)b)E<j=0~koBuA@_dz6A*uLWTfl1-n7S~%R)bky7JU?c5M=ePT?Yauizp0s-
zpTKZuE?g+V<4hZO?V|INyn8ubaWzvR9vdmDsHli~5npfMb}o`5xmu~^ND`M%E(0y~
z)YMcP9%{KK!Fp0!`eAKZMCjzg*PBP4oZE{^>IUFhSXH(0{(5FfHML#Pj@=6u7j~|q
zV{{P@-*9uQa^mGAwLFvGUjpTZw)&Oc11H=pDk^&B?AeoeIrI}xr}>$1Y{e9Cl*#Ob
zVf%>oRm>CE*x7#qRY?KN`1<<Z#uRt0&+$yX+BM_7wRfYVqrXl*NJ`>C>b5ves($$J
zfu>G8qUr@0<EKxb3J05W6B1W$+_<r-ugKt72j(_KS?s*L8=z6ApBw3EYja7;pIMV@
zJ>+(cy9A@LM?pbrn3<V1#4^S@92^~eLqoX@<QtTtfNZUzH5FnN#F>>M<=RniF7Dr=
z)0n}vY4he}2q`c?tc2z#?&Rc@?X3&ZOuk=>DMWVP*!eQ^*P83ECZ_ML%TMThtzID7
z)ZAQVDSSdgYd!U_M|XBr-}n>|)<}2Np4V41>EvR!=%q7A`Rv-deBy8*txCc+{0)3Y
zR+u_nMV0OJ18MeCa&nt)R)lhWd4^{JK9!ZdM>DI$;~82vZ@yG7a1wBw;hPw2UK>&6
zj&9cGyg2C`UaN;crrnjhwY0U{0hPJZ=cw;4gRm`m{W=Rc)5=(d2OIZDz5o{?>jn_<
zLV?3`es?5_-;W&2g9;p5@hVr42^KLiX3S4ZKy%y=$VXlO;J&f4$3nn<f)hd!)t1j<
zL+$Oi@e8HArc6Gb-YOaFHIAx*vBCz=Vt04<LckXmzfzNdhNG}?iybYNu^m!RQ0#!4
z<{h*_Y}T@U`}RplO8%@<cXm~b-zqn_Wl%c4RxfvOD-RD3JTTOdc~)Y_2V3$y_nr@+
znYF<4b$yInK0`+JDJzAn2e&M28?(zBZWa;{I1#JR;E)7pv1QAa>!9lbX1{32h2FY#
zYYsJ7z+sBlLXasqB;@!T7FO1mb>7#wrOusOBO4;PSJ-0~?%)@=Z>;g=@30LK&E$>s
zklH7$!>=ME+cR68PMtX6^2VEMUI52y%Co=n<6}VbL$1va*Bne-|5m$f8@$LnY=kwP
zAlVI1PL@oKbd*_2ry944@)<Q{eVPfF3>5K6_D(R!{to-5mA^c@U$~?fL#N;_7S@#e
zhQ^fLFV|e2ay<#})86t&`@JM1HcpJB1=6|J*$1Q@3<z$*6Nw*@Np~^KSUbIqE6h`Z
z6*YMi;=35q=6Pu<Ena$FleQBpR;-}0rMb+p6-ReP$)#b^#g2nZY2Z08Sn_!pygq&X
z>M9$3*VA)tj`fiDHZB#K={4hajviflwkP}Vt=?P-z}`J>cdfvQsbFE|AT2f3aw;lL
z-_r{Jc>#R={N#Vx>7}bUK&I_(&gI9GORn=Of<Cx<8x-PXyK%kt5tXuzaNGv?eF?<4
zdu?sk;~D!qM?$t_GMCL#ILm7F(rc|RPGN#eTd9|>)0}e@m1-5f5V^Yr1sPCOgo2J4
zu8EZMXllBKU8S)V2vc0R)m%`jbq84tpX(t!ZP0FSZDv*kE&d*yBWqiIIt8zq`8U`l
z;SCsmi5B8zm!f5v+Cw&khKAA~)!U+16Lb6ZYtDAYa}m`&ZCzdW@uVru^f}Zwob3U)
z4htLG3I;D~z4V4e`(m>es0va;EqSinx1NubvlwjJ0WPxnv$EO&f5f;uhftuj8(g(}
zjvwEFH__42b^l1-lctjJsI}>jYyv5MYHDhqK7YQWlJF6}PpsXZUuQBSnQxU+8Ecd&
zeN16aS1~*~nEETt*(^J9{aZBJd-w03V)s*C`935h1R|vR3p`MQCF&H7I*=$$`Rw?5
z^p{dNUxu2#eVKAg$1+w{dw0~o68?sb{zaF#i|q9eo3Q6o?8TC9TRSj4O0qxXEEpi%
zZ)$4#=nNb7U+4Sl9dU{Ydgd&xn_lEOOdkeWxqj?<`@nz~f@W*|{k>i4H*d023cr3`
z_ciFKeN^B^R$m$p|1~{5J?>s!#TYqVx_FVYe*JpHHvR3}w@u8<Qr0lydGI*^ovEn~
zAJd^05kwGlM5<-WmStJ=Y@)otcn+r1@Y?gP!!{pDXSs2M^@gVANZUIqg#?wYI1Fsz
z<e|be6)rq!gk;?NOO~hS+SWBI!KgQE-h4MLjnBr$<^`-(Sd1*YaSqCs?9c$^o$&gI
zqfkDS+yghICmoX@jqL%hx?jLTSylrKI3k8}8yFdB`T6<7JB;;@pO^pUB*E%y;^R?#
zLqI^_1z?JJoPW`zS6CSH+qZA;J>{PV^(I#>&Axg0^5vCTrkWp$i+A(ztVfMTJl{v^
zJofYR<Z^DGO?W+PZDDb*N(YmD7rEFEAc(%`EjU-2ejOc9)<=wgS^Uqn4-NT*2w96q
z%DvO!L!nX{)I?yTgs~hru$tX(HL1{ea@u6%=jmU+ekp~#_jA6AC5P+q1GIqMn>^5p
zRvDn`ZRb(@fCo+6fBsx9CMK4Zo4b9-SiN16(x*-{dM`;fHa3<$d#Jd%x$#*ZCr+MR
zmUu0Dx$l`3D71XWEsRh_cry30+AZTq5j(4JiKEPs$M?)Vr%Sr?EFKbf5a}H-PoR1~
zD(lp#OJss@;|=fq_b8`p${!C0G|fEaQFoJ!xLv9xo_h0ZTYLL5bSkZEZDF0W+J287
zx%~K{gw|Bl*tqlL$&<q)BX}Xe$aeORPfDIep;P0q2q3Nu={FIJGik}PXEj}m@DSS$
z{swv3C+}_Av@a<y7<qIT&=>AYIeD7@`X-MR7#&PyYDc+?NU&~%S)bSZ!*$*#0&82}
zy*sId0hE8Ev})P;kTpjFrO}*D->E9L{D8TDdu8Rt-C_&XYEAmK?;c68CJP2A#;2>O
zW1&M@qC@)pT5qEQo?+XR!8K@yAvEAe{M)erI-|379}JG2imu)|?PSPxOZQyEh4#@S
z&%ajc@D**QaUI%;R{v$c?H`7#`DI0227z0-pO&5HBw@fgoB1WG0v#3NQWeHDH3?U@
zBWrYZb)WHSEa$$KMY;RV1y}W2HTQe(MvbdO{y+1N+<iyMQ&azWl%v0t;&kQ=jaC1T
zWywmMUtV(z=JE_?*?i8En|jOHnetlyc-^;hUw8M<>Zd37d2onp=L~h4Wj}IDHgV1r
zaGi|~s0kw@@UQb(Dc;&xDMm)dd-;iq@viT#Z(y(AqNbL$Ug?^1M%Mh(u4f+&j)|p9
z?~new{EebzSyiEC+cNV-I&MEbtv!>w_vPYy#wiJ&W#{euZfW$qYWQgz`5i^NqRBT|
zSWTHBwcbE}*I8WmFW2ni13f}E4H@iyv7f$l@2j_yG2ptTJSqQeT4W&qKo5hMZF#^J
z!M*;A%9B1NR4EZsJ~!ZV82<A|9Cc;4?-|%ase~P-F4A9fb#vR+lhueg-ZB~DKW-eA
z_D)l`Bwf3;c;G&&Y_}z9wSkjHub<<7|8tkMnCxdvw?%qsbL#4@IT$S7rQ2BlEsSgE
z&{t3Tz9+C&_hoI=?!NW3%f`k1(>B_+&6grC3naZ%gZG2^<f|?`Xm&Eb_9r?68luhA
z@b1Hh52FC$f>^eBwhs<^6ZFH$`C444F5vdPGi*2Zg^_F6d&5}FTQhL`{kkA`HOr-=
zYVk3&|NiX;K*@^gfan4)JXR4DUU$D!TOK6x1fFKvuydy;0my)O-rnBGij$C)uxBsj
zK6YCOz6Dnu9vj11$eOrr7ugJ4bg5JOf1GO7-%}k91X3G;w7Ru)+1W8Rpe>HeaRmQ%
zV|?aYv5xwbYlRIzJ*`g5+vD(ouYNK*yO(sR?&;)A=91(up6~T#B$B8AMq|ElaMkU(
zq#+rR{H>LzbDW!s6<>DA{R1VYoTER7RW?_}%U-Km37qub*UOj4$^U*}WsSS{fBg82
ziY$?POt5?L4OAlc;>ZfWcKbu*-`r#Pa09rjjUrU2M6Tk?07&}#4X)){t%LS=3LxxT
zb+raB{R?1MxmeufrA#ALJk`4aR&5DPc33ufyr}NE&P&fRqwx2Dk2NTNPxla%1Vx%#
zJ^vw8;&zNjq|D3?r=+H$V4iD|<=hs5wgWsSH96Q^h3CN)lGK<OyxeX(EZxc`UY83J
z_|n=JC{2xvg1K4)lXmw955#3<>CiZSnH^_jVmjYk0s{rA`U3>;OIVDjFn6fLjD_?q
zpgEpj!hbKztmC|a2l=-Dg<R~TkPt6uV&Tq<3j!u>6riZ!;NUi(Ao&G*;f0MSBIQm-
z%I)5}cO{-Mk%ClgIyYqs^m>NvahDS}xhe^T>_h*qZx70Mu#hz!v-8{`r@0ZSXJ2m$
z2nseZrtx@O<G%0bxB2no$HVwcjvD~HywAU)%yueTE#0Es^ndqAB_$=rC}2Waoa+)p
zdvh+Vub&R2n!J$mrA<Bg#!At}IdiRBw~n|kt;iUICf(8+y_6F;ep~~WM=xZ>iF;7s
zs5KV~P~vn;O+5lMb0729Ip`u6V-+g<#w!M%{k`zxrqrTj!>i<RN5P_w40t-}_Pgsg
z8b^MrUc0to#|{sy%rYOU*`=3{*|qO?A<GuC!YrE+6?5uO8IP~O|9DY#JvlpUCsVk&
z(7xBsOZOBP{4e-8+|IDwIm1?jN2X22doS<z|GehFUGeZjJf3KZK8oJ{cKGlHav_(B
z|BD#dYd7t?5c;7!M5w*HTPeyBALoL;`Aj<M@Y7Qq{y)+GlyWQ%;8x{(mfo5t`D1n|
z^6l>6wq>K=L%9jB>l;`T^jw-9AQK<ivL1a(R#x^=sTTOdDJLh<hmsM^op5KldwWY-
zSn%CyUkd*`$yZxdDdZMjewGZs*oL$fu<U)Jy39OXWgWl(9HuWY4n?@$my5lp7=Id>
zLB}lm5aWFD1jSR~7YhxJHKwU2E77K_cmak)AYM0kNE|ahzqE`zJV<S_jG;)FH((w*
z=_=2wyYTnh>EF+vi8+gki;F*S*hNq8{^kuYEj=#<FroxQ!G5~~iE^<L($ch>Hf^eW
zb#^n}l3TuXD0ekc>F`tJ@Cxn<9H;H<1hH<b0;O+OA455Vj#Y^D@?0@=l)<aEKnO|z
zSlS6z-ycUk)i}59Ie2jGp+korojbms)NmB>LdsHDT-psBRhOhLrKcD7b(sS)uck%;
z$}SIu5+Zvaw*PR@8XJtmdGTmnQ<mu|r2_l|4J~b&{kA+M&W|wte10OeQ~_{-!8!jf
z5G53t(n2r<#{`-Ix7L6RGzFW+hV9$$gXxO1`<=vPv9nVvD=YuVG-m#A;}EhO&yZ8!
zeRuszJ-&x|kEf}?nc2w5$jW#r6(o4J|F^Ct^D~z260EryzNK2cfzr>888YAq*Hl%*
z0srdZg;7(g(>mM^9%2<;L>N2Z0M-{c>D}KOuR7?x>~C7_1Bc9%ZUh2FKcl!*=}4HE
z@R9=2)8m1u$|=r;0@?s5;O}6IcyV!me~Yt~)iF}ne9wGVko=q4wn%M-()v*|Ar$ZF
zA3|lhd<OiXA@v5_PZ>ucE}ReGJPEDhp7#1(!i8kU$*K01ev`*5>DB^BK7eNR2EQlg
zAAX)4@^KGk{%$Rip*br#riV<4*#yjEVrrT^J7R}p+y3h8JQ-c>Uv|QCKyn)Ju;S=N
zwx?yV!K`b_cibr#TQjH``1NL1PEHYYAyA--gy5vRf97WQyzII^u+!J^NB+h<l^-)3
zFPj|>{PKHyH!4F}^xIX62K=Azi-+6%X30m^BCkyQe;fiRyXWS{%ECf{T#G#vsf@nB
z3?Z##aHtH>jKg1?)tA?+{K$>#ce^{^O?Z8>GH7*I<3fwMZ04Zw1jYBARfNNj=g(Up
z1f4?Oa6iQ#P4IG19~3F2)SK(PnZ>;E{QSGRy6x@l?byd4)nx}#>uIyEm9uQym}iCS
zg^+aazZMv00K?j?$zuU0<}q0%JPGaVZ=(Zn#I>zLJSmpEv33i_s^;bjLHZfsW+sJa
zW1fS+-`3c@8VYf`envE2qQFrMp3STMc?(3Z8!$GUIdjGZfD}cQnvT((T_%X8@ztwW
zKUBH%)Yd}^v9YzS&*S=cynn^dP8@;`<O~fyhTYqqE>y-zMw~>QK7@l(PMkPF!F27;
zs`a~0L{t$T2jo#Svt!4OAMgq{$C`jE&CSn;D{z#VDE_U%DH>~-mP*q;h<}Ax7{QS8
zsBtDnMw4HkHhu{e*@>Ol6krejg^sHDZWhXrCRENW+fnvkX4$Hp7{J(Ia68c8MpE5f
zO)dEL-%hdul?`6)pLkZ(#KdI3r6cMWpfCnvKcUifS4XeMQ$=^Mz+|JMt9OftFu|Mn
z9`YnKI=!tmnXZsCA-GooWZe=t@;CGY|8+HmhY)FL#O8*nYV?k>Z8{s<=Lt?HDEJdk
z1UwV6=7s~1_QHh=yIsP3eU~LDu5}gHupZt;!HZ$Xyv=Y_@5#u+rR(k1e!oR<X(ft*
z&|tZ6aDjs}H^Z;26YQ337&t!sqK2e6K)XY^x9ZAUML<2u#|@Ygt^Ut4e2y0%cwu8_
zC!SQ-m<RtO4&o}!eiwhAVdF4A4uPB(mWrwAX@6VhzkBfKzb3UJKR^E&pYEm_Jxf>r
zlMz)c$Ob&%75C=9Zg%}I{^>q|LF;Xx9_Hi6k5}+{=93nUDhA_|J3f*nuTpcV@mwm_
z{O|SnCHzeuFJ7?x`u#iq4NE?vQ8MBk6#ijIU~eC3ZX!{3sk7)`r9ObC2fV>ei%LpX
zWoKts%-cZH0p=lBhr#`HlaJKWwfk?Tnp*ni7<gwP#=w<PGCP4M-WwcyI(rC=gpXkz
zfExDWA*y%4>|bPv1pa#-UoSW~T`;?A!^c1E!)y5%WU>buwGQt_4}lN(9rp9k%`eZ)
z8u|Zb!G91S<?i$6JK-=~MKo2c8ni9Ps1x~BI$OT|p=B0jgpy3NZXH+2rlp0bDm$n0
z57yf4z}#rNYL3M__*33M*@exF87$|~xk&VJ2qncvw~jqWqX#g(4wMhA6CZkY10os?
z9i3Bq*U7)Pz5U;9YhyXxP!KghY0&jQqAd~#@+vCoCkWx`Kfj)Ty@^VX&%oM=kH-*4
zgjc2OUjfK{Q&fI?DFQkEcl-8@h}c7Pc1R#6lj`;WB0_k{vL4!ntQ{7x8S3qQfXFQb
z%ZAvH)P3Xc9`7yrw`Iri?E3KdxNB09@#*cZOUG6-bMW|EK9*MR(%uh$U%T|v#{ai}
ztkUP?=ih!aRe1`^90B78)1;Gfpy73o&phC!-dJV+)X(qkuU}fZnVKT20XB5_f*x?Y
z6=Jvf`7>X7E-met$_+|b_t7m(OkPl5cVhkb@83_M5CsGR&}jmg7Z>IqaQ{5mg~nk6
zqe2y)GE-A$wbRApH0{t|l`;%=z$NSg1I6lnvcZJ_@2|g?efjbM;P>G%!-nh7@s15V
zA7=x(Af*^)BnDzE>i$Wg0NUJxg}rf3WYfmHFNjCj&b_eOn)sBcDFlis92|8E_qD-<
zl)gRSrfkf!IeYdjAr7SB?wGn&9(+<#lKRGt8;?Rmy^)HSEe?e#<6p|d#MVP`fn0Y*
zM_Eo@9y_p%nK^6?*Q$+|l=0+EJJ8BUcq$Qf_fS)5A)j^QF-tPUvaz>cJ8)J}aT~do
z;o)Jq$qKtai#J=CkDIN4w&(xbBMW4(9kN$9#@S@+yR#oag$K>u2nq_Mu8|!de-PBr
z16u#(sb_akrZ1px=DFc>86ml$j=wPg+(H%*DGp<igJ}+(+W0gjrF@6u_?W?K?IDI9
z63YSqEWdiVt8IfC^brja!xL{5l(+B$m{?mAQ5|>bbMM{?h-U3rMWq5K5eEl{H~8cP
zLSkT(PVJ$8y>A)FV5Hn?9MD5TuBsT%jtU4+d<vLZUtS>}EHHv+e+agQAS;2P7HDC(
zV!ZFOXYQN#$+7^#p`pLWOl$YHBZ14%W(5exq!gk|VQ?DTedEc&^9$Ga?TdcEy=G(8
zc|+_#mi;6*M#2x!hTpw^e`<;or3L$4gj6Gy8o&<FgLdaJT3Ev3E6tEq{=YHf`-uKd
z<Tsc^q{Bp+@NU#^K&OxRv?N~V1&99Dg4W)74U_|(H7EuvC}+-}Kjq-?cGw;6fRidJ
z3`Bt=av;L1w6qk(0nkhQ;>8Vj?%cTt#dQx^EZ~V1)YL^~W#^~*Q91;i7lZ)@i4YGm
zeJ#sm+2l~Glt0JiO3d`)QwVd$p-e0+Bya=w%pd|rV5pa6*|)7cRAenhr#5aYK`iNx
zkVVPtWNgd=$03spvBl~2=zgdl_i*1o31LP=5xHRd_U*wU_S*;}hf4%{Dd!gf&Umtm
zA3wf4=g&d2di8C&SWYXE)cS`&<GUeS0#~{yaY|xCt8lPQlaB30D<MD@LM*GOSdX5a
zI@9z=mB{%50`%qO<pOqN`^n`HeABm+mYR%y;Iq7Q|Nbg6(-RO9+HU_PD@y=z1AT_b
zh)8wU=g*(l3QjcfNR0h~3`dX>fIeL933nzb7bDMYrDfowK`MjzQO@aZ<}^sy$8|1#
zb`3I}P#PpGm8<w|e0oT@a_UXRz8@-!Dh(w>Ie{$;2P;h0EFrz>-o1M)s9G5Co`AFo
zvGu-OQZ$#gebBdFP5Z`<BDhoUVFtqrc!ChXJcWzJ-z@8dL{cIa7yf8|WX;m-1GAub
zQ*wzo%o~`e8Aa^UepuW9d=kgyeEaqdaDKy<E%yowPsCfUnXG_rCj(i#4O5&mGBT&}
zxJD(BlN|eyu=s!yYPhC=xMSp_>4?`?L&Uysw(F4O{scqrgmrsaSsUL-$x0M<1p9!@
zN#T^kXrQaG)<r2OaW5b~5aI`Y1tHvq#z6*okl-jT@B=-hKeQZ$1Ay48_H`Lt9xn;)
z!ehlIy)_3=ZOBLipW}or{s@B=0V@~@Jm=rY!0<q9ac(m{wdW+l&tz&?gJca9Uv%1H
z_~T3#7aWmII6?<}oP|KT_c~y&+zI~^LAXs#O+*2}!$r#|Xz91{!3Q+jOkz&L@Tsjw
zNEGStK_%afA<V%mi4us#{(Nu1n`ei$*TCS;{kEp6wUrtEH(6iim2z@&yk@`7kg^gO
z7+7S6ARZfR-iZ$bWx57;!Gs7tUXM&6fLJJ$|Ha;$hhyEh@1iP|N<=D3L`h^SGGr>G
zQlgTGjHwhtkufB5riem>BoAfEROaa>B1vX4r81K#(>gzT-u<q9taa>v_Hpcg_UiaO
z@B989x$p1yGhD-Yp4WBZ7$ET_Nf5T4fBf?4aM6t@jW5FqaHgp2Cd+}28->`2)N8eD
z`m!7x95c{Co`tfGvp*eLoM;sAQR6)|vduX<>;_(QP6zN$Z(zui0#1aGA4@z6ZP+dm
z5hg@T0%?(4HvZ>YsO^89Y&tuwsc`I={&;U?w!>^%Kw>9Cav)75AU-!bIXS)mrF*J<
zD<k850FQdVf7Dgr?83V-;NKAD4riF`e@twwPcY?c8mcRM5?Wg>vA4FeX~FL3K^d8C
z*|#3y0UiW8YiF2~m$e)*7ZKZ2gQ)1j#uGhr=}9RhXJu<f_^qyKYqKIAqbh7~-$_y+
z6liRk5zrQ^eJZ>bXQC<3UTjo6&lpK5LDRAQE2+SMAAq(b;;@y{lSx4wComf1IHAd@
zb>noOv|>u!f6gR{&W}Xr&H!uS3_PLnQjOOFD{j*MZVNn=8_ocDVk7_pdPsdBv|V%w
z2-uXEn}_7^MrVi-?_;H=y8uoDf`cF6&gw%+Kp1#fG!Mu&deDir6kg|m)h{(FXGGIV
zadJ0q@S;H_f!C2KbwN1d>E%@fc!guD5AZS@sv`&&7&dKkuBbRcjA>C((T|QiN!Y=|
zR==o`V!;jJ<RBPZvADQM@Om&#=BU?-5Vu%~8&HUjbv_%<Jyu9=Bsou0zN4g+wDbY6
ztpw%2_(r=3s$cKk4|lAs6#<bD$_Q9vc6RnI#BM-z%0O(AtPw=hmgc)K{g9zir)oTe
zFi9Ww7Q0=F62J#Hlhk;-1_w!}v{>9kjV!aBBvHl1HpE#WY6(?j-1CsU61#<n*kZi*
zB%fv)HF%q~Y_<6;(sm-Ew>lm|TA`0kd8LzgI3^}$6Cx<oMN<QGmWLl5%-8k&(T9bp
zg9exwU_?qkKF4i9I>^AxOan~>7-Yx{*1(l-%j8K=PRWXV8$Z0t`F#8tf@Ko89G;7?
zQLh?quu59fLhXGF+yy>h=pQG3+u8K=^i;i~mAOlcbJssTci9w?5~170F64dwQuE<E
zKU57qaM%-*YDnez@S%c@O}5bfbl3vb#0LETrGQJ6q{TR6LeagmACT|2fdL;ZZcBzK
za5Qunz8?|6N;p_hX=JIbM>>3gkZ^Kyuf;7zhL!OvD*5vJt@v>{!a@=*K-%;TC*q03
z?Y;LFXRiS|Jsly=fB>xs0&{oJ|3Egn;NyV@MUBS(lQ-#T>&q}`9DeGiyq9N%D8h=m
z^DMrKNGc8BWdP2trGkQTEd&B=xDnWb%7bgKpon8X{A4%I<&(o!yb$d90kvD7zHY<X
zZAi)fQA<D@$;@a#TU1o9)qTLr>;3#3H-jpzI-nc5D5D@Wy501!FOEwWioFqlc{Nmz
zzz0w{gE&SXKN3E1h+F*p%!N*A^Ynx|1>4#K{pJd`_y7PK>PE#qOtjz(VWa@X6(U_B
zXcBB4hlq%p#t1alBw%`-IXOC72>+&<epNZK*%yIB8Nw}wEn8Oqg(0C4*8}8AXasPn
zd#b}|>FJNd-&%B+t|M1i-Xm5}=J9{D0CZcX&a0|A<G|>nWR=Pp2bs7Lf_x(8N`;0Z
zI{lVtcq*zf=Fv5y_`vjFvn#fTcz0k3+t|E_>4$-F$FVoWM~K^uK2M42w=LLow(MtT
zfh?|K%GHnCm)U}3T?#(mnIfx*w&CpLW}>fT)E~x6_5&yFf5|}G1bfki+e)rCEW)lA
zb6)=b$H~#5XQyk@T<RY4XGStbQUlz<D;LU9fJf>QuOsaBTCq;+gD6fYKwYNyd9Noe
z6ciq`3#wOt{8(1~RCsK(Oa3=fM%l%g-GKa7P@$pGF%1o7G(o-6C_}>GyTffR00KQc
zJVp&u_@Rk_HKzr=wF%S&L^1mxG|%bl>obd7-vrnE0Imp@UcTuJ6fw|Rl_E@cGh$<7
zdm`g_7@HgT?Ab=>dP++bP~^1%;RfTcUI2?diOKndD2n<S5oPsIZzQ|d*mNHQL$iDG
z8Sa?)gWG+{tw&=WLB2%I^u6H2Ar6{3Eok{jDNZBp$~p)+Ea0!JpGj`RS81dg91C=)
z46$UY*_@=hPYCsRA~(Je&JvkST1)w($ind@6(Bp;(aE);x)?z|@$?3%%xJDCm*ND!
zbiMxNMi|j6lLaKBg3qFIMxF)8BNoD3^`ksg*Xv@Ar8Yuta0y40pha-m&l?Banq{x1
zvna-%ZOUpkQAA`A7#iv^Gh<Uqq3q`8-w5#+EZTF2NB;i)qn*fuV3!eK0h&n-OPD|#
zhV^~vtP?OoAbpV^g<g<>Hp7c3dta%)-j3x%hU3fGSwE4j>-nl1P~Af|>Fs!Eq5{fa
zTC^wHB3NHHM4oSS^1Kmnb;EOm#pfG0jCaeMd?9V63oIG5?J~Rr52T*+XVt1z2aqTv
zIt<4(6u7n0<>~lCjS~xT#<7}{32NQYH65M!{_#}qz06=`&cI-e<M7c-h#*uJR>X-D
zyxYM+il|RWlRO%xE{lbszCNzE8x$0hw}YHP$OJy{{htJqN&5O8!!8r&mH0&xD8<q1
z*Y_a}^<$MV$RG&sc*o|dxk8}NzwM+U*@8PFnu~|55{yWHiU6^UBD5%KZEYQ9zu_~%
zXGm>N;Zpf)(FiaXhfO6W!)3TQhdIj4-=Ch8+L2WOXAR3GFjn>eY$h;3UUA}*u*JIs
z1n6+WQ|D$5KYLS=hJgAgXCMigfqeoZlY_SJps+B+XRp8V@7uR2MA~MQ%4Xi+vX-Br
z5OWHOmFA&-%f8)DhfEWl3|3vdc#-3AVBa4Z{5=>gNb|~p`6az60LubS2ih_4fv>Ly
z$;|c~J1KiZ<8ZH=|19p{Hw)FFlSm35#K&_3S9FKL<k+?A$jqQ^hoFL5s+5$}Csct!
zr*}*vBqHJ=e6Bu@7m>E1k?G~`(|5FBD+Xkc#XtlE)CQ?a@|WM&roI$x1vXyoG6>AM
zSv#}4={&pEICm?ru<&N|hy|*Z@@K5!evv(=-Q(Fmf8;<Fkw66g$|SN~CwrLhjn4Gs
z<Z7z6cUBv0V(60^2e1y>wU;8V!q^EQ0PuhVAWs5-i4frMn550*U_nx((L+6zR+HJ(
zF3lEIPENoco{_HH*W9G|uZIIC!LO}*R*blbkQwUfa_dLpvmFx}ZWOxDmz43CIUzI#
z<)=QoCtfAW59VxZxE$rtbaUD;087)uHLyEEI7NUN^$`f;n~On&AZG946m|v}h%-gJ
zDioQT3jun~S+TLPDLS?(5&nH#L2f@M?SRg3j7T%&wNzid?PX;P4|o7QbXgDIp+UTz
zjk1|k7ro%<$hR58==BfO4F8976;~7UHhz)cVdIBCOo4F9IVNSP88X)9<|!=&{6nd6
zCU|JTInJ@Mh6$~k81i^YUJlj&H&BWsy25f@?0)CQ&8YdS1}^Zr$ae66ny+u3^tzgG
ze(3dFCt4Yi*o+W)NW;y0$~S7~+At8cBA8lWD*A_vDUoB1>1pw%nGw_JZ=)3y2;}uR
zsQ9N2PN~mAt~gYz@P^#vumHqom2qH3$C7f;Tdxnt;S$*8b?`2%pdvoY)8F3%Pa4?v
zE5uMHN4cxk=TvgK{j?b~gtD`<M9E5}H)&b^2pK%k>6HkyO5m@(@AUHbrBYj154WuY
z;)5t921m8n4wj5rNYA-J6j3O^IikQM*=Br5kESFgWXSdYeRHTc2^$8=HL1bsA)+M2
zx3KB{a9L9IW1g?ZwZLJViInm}3>||A=9r9%l9C+6KJZItUtc-|GSgt%@TN2hVv^z9
zUR_As3aH5f&?KkegO49R$N@=ERaMnHzi`tZmjJv?2(!=_Y-@rE7xrli!X2IDtVHQI
z7n9i_h#Cb7La_Q7M4qo@`X8Re6+pSinvsGf8Gxtmgs{Wc&}`VSKdl1|gzuA`gnHgB
zDk|#J_qJTy&9J;b(CjV63{@!sa(l(av#X5~;izCfxd$aVI98C4LUAY%e{V?89vjbJ
zP~UPufP?d|6h%#dm^djZ!fPU<CVK*$w+w8!3(})4;X!vHch<<U<jT#<OSSA%asV0#
ztr-U$tGM2z0k>47;}ci{q<NgMVE|4D^#}0U3z<9YMBE9bHQ@gdkHh~E(IYC8i*b3}
zSa^{w&7d!03Ua?a+}ykIpx~q^B(Uo3eSl4Cd2D!4N{W>L)Tn@iyxNaI1PJ;8J0tJT
zH{ZyYKKEFOtNN-isMQCKh?sFs>wZx-P?0czWHk6d!`_NOqEy4dv;d8L`sqO;WbW%Y
z%7(wwVbimbFzBetB#Jq>Tvs?pf<xk-;UH1L^jA%0Lo5JzM<33X+#iA-gNY?3JL^_w
zIRtyD7>(e7T7rt&S_-yiqpWNJV-$5-M&#R+_~Aqx5SiKD&A4aP5fYn;2f?odLeND-
z(-44(3h3n0<Y=2+T+j+b4)xZwb!(L4)YDOgrXUj@EfW(Huh{|9*Z%FufgdXk-SEeD
z_#g_CPi!ziM5mEwhc@@wE&!_y049<Q_=4Frz<gc`oJD{*K0!r|hv&dbqJD{_LL_HF
zn>0Oww$sy7;4i(A4geU4LE`uWK_Sc*vI2L6s^4&9Pn<qox-{psM31nQfLDVxb7oI7
z@=@PK5IeD39ZWLzNL!Ha0TdvR5dwnu6y3gP&T=j|U&)$6Zo7>vv}>RPzz#*<HX1m%
z;gos#qY|{d(nB*}0>^dt^e}AQ>W(ej4WCC)z%%jbEh;7^eC7V^^q_%=)&m4UVGqkJ
z>Vk_<Wl5-Xgm|lLSbx7c7q^~{P0AA`11zAHp~v?C<qM^Is(Dv2=d&+a9d;X*(0jsS
zxJ`mc%)#EGLVMHIZD?HqGvk2Pf1qQbS(Aq_6Ud+tlHWT+Ee&r5e)aUY_Em*0=cP#6
z?=4JTB#9@y)~(#JHOM{i)&K?&Dab7RJ`dTv9%h}0TXa+7+yo-QhTko|a!~U!8SBwQ
zQUsD}K)(xElO2Lt;;`9d96aHgV~|OZ=&Jf^x_Jb5lu(LP_n#{QOWpZ5t7ZvyLXHi&
z8r|LZLFYqOL7o~s(dYBiXFo5<DF{L^N)Pl!gXa4gWMGgeLieNqwFJQMwXl#dWcoNB
z0K4RNPF<0{vTVQTsq*K?Pk{^7gIQ&ku-t>kc6)bOAhZWLiw$5m<eX9JSt|-*hzMRl
zgjNXs<nfPBo?qPKq0e!rpm%LPpB&CVnVL6rfXV?qLQpEc2EutCK&>V9^_wAECM2H%
zr;B2&{sKf&NhlUsMRF(<#tM=gm*_YlV&3!i8t5;g@oi4$#sS<r|LJCeBoYB%lJ?*Q
zDk>`xq|>WHz?7t&!-&d-Rc!u7O249Z_$opWi_-;+84}5Ei0TV*$HveRh+w5~H~`ZX
zu^6E4Xu$YVr6lGHCLg#jZF>9P0Dpx;Ok)80FQfXO9*|Mj0SB#6P3qOFK@V#5N!){4
z;sHekI^_)zsFPz4B^sXQC{S28O@HjNBKp1yA-hRbTZS}n61|A+LC8*&77v1jfjkx?
z2_cpOsVpJ<U}z|?{Q}gt)^FIbp#;nVY$zQmJ^&v4>hk-{fR>}L)eSML20=|zuB|Y*
zp0mk1(zGlGOL^n&OM_x}10HCAWq>GHmYfV&g%Z3kz<bxMtSq6RF$B#n5Oc#~jRK7B
z0a-Q!J<-{MdyYg`RD3Ffk1)0PB>lb*kHzl}vqG#)kS9b6h6sp?58<ncb{seR+t85d
zg?xa^&k@>_9@7ca)KtF*n>XX&mf^$wfhQh8vJW6d5fv(<s6f{IsFpE(k0U1370*CO
zU(^vBU`fR9&5IM01=5O0j^Sl~e0{wG+&m4!*5|=?6_Iv~)?XZL=0%#2x_-iB8zQX&
zzfPV8@@jbM2YA9&)?W)$5?e=S67B;?hah-3!775^sQ$VLmyQ@v5UrM;;>M=tW)|S7
z!oVv$fb~G@wHD^344G{zsyr2rA5UN08*`B~sU@)FU`O5#0_A{NLxxFWb2!Xs96`9>
z^c!ngckWDui$n_t1{CBJ;w(aa;)1gNO>iKoe~wNY55+*B03gO0F+HR@1OP-_LLe%O
zsX@)Q_jl=$n4zMyD1bwL6l%kDtu5y}L;IPFzGmjU6@|XSWH-tN*qqjI@w&xoKbZb{
z<=bh86;t<gR*lRY-laP|zjTLB@Pwm|zpRW3!aQ?pYk|;h`(Eo7u)$@p5ccWEkL#$b
zz+C_*5q@qbLQEnWE-PD&GytKt4MupFFV5RSDZ3TVzlI9xlP#5$c|I`a(AAk-62l7d
zKK_7;U*sI*ICOQ56(25v&9uv7gIN*mwNXg+sjfbKJ)^}kK~PuiJ(6i(Y$XU-NcJ+S
z=ThS%6<B`d!;qfS%{0BWpvC%H{pPgK7gHXslY<HVRiD`s8-6u@U)|R?JAE<C`<Dvi
zg%{)RMs$B?SA4F?$<A(Sn|2Jb%iDvMqGy+(W|L*O*fLgibKc0`n>keVXJnkCq5Uzn
z*%WK8nEr0t)wUUzUbpWw1pW-(g=tQ+Ya4&awNW<zYg#QIItKcBd)0>f_<heMIGC<H
ztnm8|x?vZa%w5x0k@h<H#WC~C>%Kaj<{i0CUwc~4vxoMHCk=T0u(}vxJ#72X2?eML
zE_4014q9rZ*$*JGDhX|3JR5gSWIJ>r(e*z+m_{9bcBV=2FVhQV->8&jMnUc81xObW
zi4sM=GS6+L-GL`QrRdAQYWQ_cY2gSk<>f!WrHBCWu?|oUXf#$Ps9h59pG4^`s+-uL
zm>T}Q@jrj_FZZSP^W+{zaY@P00hy<rq07uO{)1QY`~M{!{f8Rrev$3Iqa(oa5K>*d
z{*;gRye5c9Zo=RF{c~X#RA4}s2}2`(=f@^0;?0Qk5#?5{Fq#*y&;I=#vA@4lw|_q*
z?<hwrNAP*B?idFrCvTv7Vi^kYi0}(w_&19kTTwtTH$Bn=?5;MC79~-Lcbl>;c7u<)
zIoa$Zuz`VLVcYHHXQ<nM^S_+uLqgTwvA}zHb3uoy#!FPffhVY_P|`+t0E8bN02`#I
z50XHapn@=h7T>E`z9ea$pBX$B3I=}B=dbF^&Pa2dMp8oJ!kx4Dyg@+YLg*&~NM+D%
zr%G~TNoD0a=ybMR+RDlK=U+8I#Z}CRIwB{xk|=iO=ZU5162|g$IxX$QfyWkt8Srb!
zgc=W2#xdjo_g!59=yN!PfR%mng!#&qD@6YTE@O0RDzilf;0ge17pNvM!O9mTJPb?;
znD>4AXuxa~zXSL{h*H8Bg;oWIgt!yED8N}L3d%@7%HB4<xw~L_0k@h1(<hW6)hDze
zLi@DZ8;(G%Ci-iM@DJKRXRyu0%VMjE+K`Y^@BX(mSZystg^0glgS4K#hwu?Z8H^i(
z*$prbd$_oYU?OpG@1NeA&fADco74y5DrsEajII8FdOz6C6G}?OFc%N(K!bi&A82k>
zY<hpsf^X<FgmZwsy88NzCT$Ttfs;4yui1&5PvquTT7WF+bMyEz0<02@(O_)J=n{6J
z9L|p;sFJ)I`t;y6GfUHgzt$AhSV#PKLwPSiCromC1frx|j*4)5h!XLLu~2VNIpcrq
zMoP%;FuDSHAP@CQs$IOi>ye`ZBwPy~pPzaZB&sK9jomyvCpEH=MiKGr0r+WsO^`Q$
zE&cwVc|1`4hCmfyX5F!;oV$0YLitHm2=e0q&>GJE>&;Fe9OUHXQvsq9@e)Ffj*gBQ
z3^^1+3pV|Q|A`2M3>f^e4}e&CD5n7o%k3fwEfFaHFLcqGh-c5hBBY|75y`|+X)g!3
zRA`PUBc4dxi$Xm>0Ao<O(Wo>ARb7fa!X5JG=+kgkWu&MO!~scIXx%q4NE59qNy#8-
z<q#G=uQ7~R0c{FNL`n+PRNY03J0^Y3XFmhL>)S9m{p!`e(~(jvq#mV65AB+Ba-#8Z
zGbr>!q0Oy{*~`e|uqh9kO}4gthh!T?H^qqbKy8875KQIEe0w`3eJ3{(OoF%IPo&a+
z$sO<;Lf1d-LY6StlCc4G(Q-I9NG7QsE4d--<2-nf5nxL>^dNO84bqpz-&jdSct;43
zs0hgf40yv)Z@etvOhY(sX5p)}$j$4Z8K-iF1`KsVNc&UZ-XHFi+=`3QlyMXHJlh#)
zRTulx%vvaQiNG9G%r1NxF#%xW;CAVt`~@h_WFHAk6z&q_Fr;Uzu)R3nZY24HG6GDE
z8#r4KJ1%mw-Vj`;V6+=@8}!Lr1yFBzco<2_LnJ9jaeC2H<RNU>Zt&U!f<w5B3N=z9
z9E}){WNyX9#pZ-(($3z5&sS7aV?r*l27(5nxI)Z$A9NmU4w0B3Y1Udj>dz{1AEjE5
z5fW;!cI?eAs8b~*m%oC@S=w@h5v&C~dUPM)nE?WI7^ZRv(3}sxWte)S8&PaKwn5eu
zIW^Dkkxq8_R|Onk1T0i|cLIYUxg=VIf`WpN{TIPua6HM!LQ)lC$e#<ec%;G#h7`38
zO=(RnHE0^~zQy9d2K7e*ifmkf$;Du;;avg(I=GN{LV8BfAhIR2SYL9S5u@TT+p<d8
zsM34`qR>gQCWH*1K%7w>F*6e&<TacNA^+8d88CIu4<5&0th<cxX<)gXDL<)6JcbFF
zGjnsRs6f-YqS}Mr%gamLc6<-nV~9$~xj}V832Z<e62|bWlgLEX63(s0t(HfI=tAK!
z0sia?0I3_9`!V#tOgc9TyGZ^H6v9VAv$*vUN!|g&H6&HT2{i!S0I?+%)dM#-{ZG%2
zLiM>B`$$TM$+i&c3GHxFz{wB-lO&!f=yN6&wm-dbP6@*gIRK#siOvtZrFZaY3W85k
zuYw6<>VoWhIAdaf$PlQCI64~(J}OcT0pouhCj>bs3NvtNWB5#!jFGGZ>U4wmjYXu1
z^Xe*e6W)`puC9(5gKaMNUj(g5ZZk6VQXDQSD!>2_fc&Q@qjWMbt*N!9$Zy%~o-!#}
z7HR(8E(s|KP!%+WBf=)a8sGy#TwL$Wmmam*E6uhx)PC~UYM{KHo-`coXJAVKfkCEn
z6WxxNsHh0evu@ow96d#FE2EHv?ZOA(-;lC7WJ&=5KhT$w#^}KRmQtZX5!40iQ<qj$
zErph+Efq^VK$#*2Opsul11=VT*D*gLNK5=C&DP)L|6e$t<JAhP{~Mmq$v1-30v%;(
zKn&stcH;^%i<|F4q5RDZ<a73<YXPZtBswB0!u&!WhN7eL=4k~5Q5<+wKueo-<az}M
zGa<zkF>PV8iIB}VpVPm!<7|j%oCuCvwt3e|P%z%$1uo^Okh*w~H12ADI&;FNBBCz6
z7MLnHbuPrZrh}~Vzj|dQQkjYJ4U%x+m@%wrgy#VDgZ~sWYa^wF0Od$aiKI&z>(L6M
z7$x0f0Lu)(wWBKG2b!{s{&0lhMAbEdKJqtVgSwvJBVdFOyTC0RLlp6#7CHpH0@M1k
zrE4QKJ$I6(W&H}?%)QIf^feunGi34N46aw*!_!cy!X(ik@mP(U_t^*IdZo`2ZuOSD
z!CQH>tS%{dK6=H+kS3N!Z+LaM@7>72pM|2fk0P!trTioPJzZyqZ_es8TIptuRL}kC
zh`KeH5ktB2!lZRCD;;{T879ZQctJ9Dh*J?PSbLdzfBhpE926vv^a7b!9P)aukZmCh
znCax0+K3QO2Q3mm0IvpAvIhF&>s}Lw(HanKxwuG_3ZZUy+wEE-M62lQ^9;t7qG;#s
zS>b~2J#cZAXbYo=nB=ALIeaIt+A9*>x$6hdOlRdfmUjK-S(^^=2;!zw_#mYrEx+IM
zA9~E^ays9$Z)2E^J?kt;B+zU7tlwi8q4wQ&D`dDqXi}i1KI3Bza*Z$I`j=M>+qBJB
zz*zR7iA4;!Hv;`35;QN{a*?Su*|b&dm8uKuMEQq8Cd(Xch1jzweYQJYJAK4OvFmzi
zjEj8qXGPj~?PjOz_XrC5>j|B(w6sj^15T2%)Uss~v~@aA0xE<wm9P;kQa0vjtSPV!
zy+T<KEL;P^1TBRNQ61Ea{6vJ3S{KU6dF~y|qa~6%WagWZN}oXNr3q;uI?i;hIDS7g
z%U?V~rcZDE+}5fzI*CgQ<~1YcesQ@AIFiBs_tLf@IS6z;Jdl)*hEDX*6fUgbc3wb_
zLAx<Lk1%FVLh(*mDALdc0Gt2opuj)^e^l1g?B(Ea!7lEcG!&%W_hI|>9qukhnp|I_
zWSwNt@PUhmC!spSRz-SJ?MCC9kHC3K!S|BqHqiu%k~FAVck((;_y^ggSrwDkmmvIL
zt)622J_B`PY>Y?bfgt`N%GHF>zZ6BYXQ1>%pL5%%ekuyRSJYKi3!$xc)n^7wb{~=`
z@k~Bp;UHY?(59Ez^SZ(F>$gljgSokaGt-7yy=5V|_~CEgzAZV7*)`^@YeTCpyj;7%
zqrTS5^TcezntT$mu&UvvC7{s+mOLKH3;<4#5Ne~Vdl9<85;Q~AV2>`;eTbY5unw3j
z#jW;_nim;$S@soOaYP;e{N|9AjglPBc7@?d1Ii8gNHrd{1ZaOVG)xRT-&1;u`Ycn?
ziwmcy3>aZEUioOF?t5!~0JK-ex*de=j{ipsP==H}1b(a@9ujk0Kdj!St(p{3OO!Ys
z;H|^-geq3iOA$d>MNQ4s+3~)4w4}a<TnlyNPtX{Lamr&S#J-Y{sdOhhE$oMpdWkj{
z$p0-UJMUs(m^<U#2yhX;7nQZOWYytvCOzLg^{l8Y>=`2_yGNW)E0b@^Zr3I~M3!ZH
z9r@oW+y3#4ZH{N+9h7t}+65#;2t6qcOwK$7P*;zxV?^rPI3S%gA*>t($v>Pr5u0n`
z1u+-q%PofBtf<WlfhDmFGvwY`s-hq5H#C>+!Q|mC^s>^!<jxoI@j=g?eZ);S1`-9r
zj(;mFHy2kOy5-`d))t~Ez1lCDT>Fu{P~;|Kpszne^?{<(6h0p?ncu|e@UQ#uuiY0i
z9AfMCxg2?3y2@2gh{oASvrGqXyc>z_K>)(&1SWu9prh#K2Io?6uC~E~6^cSqh=i_?
z+rhhBL3D)cjNI-c*2^I7J}ZS|6Aflj(u<!Q#;$52qQlHa0dyhXh%e<56AML{Z2o~K
zUI;zxKr*R_vwqK?8zxE&!2BVkKjf2_m1vw-g7~Tk&AqbwLbM1(<NcU38%>*t=Fv+r
z76`35fYs1h$1MyJPthg_v*HTIFd}8FVz<8#bPz}=XCa(M!%AI)i4>-xTOaC=2j5-z
z{3m$Tq_CS~KSCR20B<K%R4|`A2q9?WKp(U%(TGI*WD0=))g@`7p!Uh~*#=>j0Q!hf
zczu?S?f8s_`o*j7X)7o&ee=Q1IKgsf;HxhVt1#XP67VCi3ZN??M71c{C>DJ9*PQqM
zH+pzORN8+c>v(*GYwzBJn5VY*J6@Iu%b;354zrAgDod0L7cZA_g=#ZuW#J0oGXkGJ
z)r?^+LVv20Ld-9av6bl*pbZ+cs0lOVgS)u7JrMoEkT@1jyyf#jW-1J$KnA#>VVV{;
z9lapBVX*|QBh9kHaho26g(=~RDz)oEt&4Ct7IKl(&kjGvz7Vbg@Mn=}R(m;m7_BKp
z*CdU62MOStMrc%}_C{MGa{-NCDdfJszbgoYO*55I0*pM2eF{2Bklv{^QWMpyBEvmB
znHq`KNJkK)4lk~l0oW4I69{&;kAj-7hc`1=Ah%`wjqar=%jfsLXF2xc`OM$9zr9{}
zA2l719zV9y=noADC?wwr(MmO(AdQ<GFn(%(iffN}9NQ_)ISIOScq#@Vm}ARc;ZV={
zA}-sF?{c$!1w*$A{ha!B$E=rIc7D$34l5=4T%1ywBEXdj_EX43FudrC`TJbI3k6Vv
z9LJ_z_(x6RS5O?<K5tBJJay?(%h~o@`<S5i@&LmC_0_4%*O1h-L9+^VHAX0Z|2Aer
zL%q@_ujAaQjjVo%!8MxQOY~bs1sant2qC<zM!QxD5L;$3GuDfjts2fs)C85)&Cl=r
zF!smxT(8aHOVbOfKRPXM-#&Tzw3J?fdWTH6#&4cu{tK#(RnavgS)@Y$2<TJ4KdBWX
zBPafdO<v?2JHC7L7?7|R+R$2_JacC8^3>%!k6L3fM)oXPIvh;KRFHe2RGfznO?qYu
z(vECczaBJPKj3F0==y+tBH{~;y%WsI$sL8FIc<FB^sn>lANMs?wJrsVWy`i%D=74S
z`g^uLsp_r=Ul&mlXO-#juslJ`C4{&fl9D@|0nY?tL)b=27#U_ucyF;=a8B}Yax!-Q
z=Qlx>?}g*R`?F1suQ}cdgVl`e5vf)*)H=wvmTcG`VJ|M(&UtQ5P=UXlc}b;9Fup5G
z53)!|VU{I1d~@25O*#zu>!ZlXdxh)n98>81!Sla<*-K*-C0pjw$DYPa;gj(7{?q!N
zo)ID+T8~GZa71B3saWHf4Ap;tN&Gj@$ra0vjW{=4V%BqiLmgsv@fIHczQy04mU66K
zw#R>e$Z2un|3|-C;h0N*M8WShNuM>hy6dx!$Oi^R^oWyUBWw0|`#(GGAB&Ni9%4Uc
zCgi=v;t0E}L<j4u0KINeD`BiVyk$@C?9h1yD!3nvnAoM}CrPnLF@1k};8*@*o3oK~
zQ~sQ+Ry3M)e`YGjzKaKR%XS<GrV8h0!c(|SqLSI2VQ#l&%qPeFmh;Tc`p^F!5rtlH
z)r}7S-OfPq7ytfX86@6Ahu{70Prc;VFW;HvpD8GG2dw-*ze?8P|J5?(_)o7`z8<B!
z>qW+9wVUW3+-G2=NOXAYS-vOSEdO4bf-XxIKwCj0TLpIAtu+()HFeEF2E8rVEwxI7
z%t=B}S8_>U`FGBp;JUNCN%u-d?oRw%>WH6SvNG%~h%8Q%%hvW-tZVL{*2~r&Y|h&u
z^dS!}7=K>u`}cd|JQZWJmA9>1=Vi3M)lo)lbEjR9?A@PmAGBp7cSCRHEI)0<t$&XO
zkDER-v*Osd4iV+k^?X*2S*?0suSE$hRps;!wzwFdGntd;7c>dtOwQ5XD{%4W&~k}-
z1$&hH!t&>^-lz0%a1?<l&J*`jj#Dyj5`9pzl}g8dt^W?lFAh*8Q#>de+5C63S_{$k
zJg<6vf;!9CAWVSuny&lE7+T1!rh0MV^d8ogRcU?`kC%)80}cPRNfk$Jq}eh}+dtH+
z(CSZB|3vre?M9+Th0o`%f5|@J-ZfgC!aX~muF{m*x9u~p`jz3qr+40ua;{%LK0Dx>
zm0~)eF7roEDWS@KdSSm<oB7V5y-tNcoTQJ{*K3(C_+|-peYB{KnqK|V`189V3GKV`
zPG?LtqVBJB`)lO5H~hPxYrk1O?d|J7kg_y+WhpoC!Gk?tlXNP(N4BNfHTdTqu-Kk4
z@M5CsyNP<TwoB_!xrj25ZH@PKTUM{09c)W|#;+yHZaxcQ(mZ@kfl1BxM8W>?iP{~@
z51u9w{?>a-bE>1Hu9HM)GYX$3l5@`l)t}kTq~^Jtb6Ot!_kstm5^CQYE}F!hD9<hP
zEZv#@szXtUir;g~zJK@@hP7lOMBQF(yxTrUm0qyumoy<6n0|AcX8+ypp5}=eo2kY-
zBMlx}YiSRE8<%NZ^gTk|W+vw4wXV0n&q9Y%;~-?nHlh+$GLf8rCjI-h(UM0aIZNz!
z1ENCxjek*Why@7@a#384^E_Fdx6swU`1$iUyO8IX^(UJ|=O<rk&FFowuMVG(Xw5V$
zN{v=(xbrB8G&b;R5yd(DlAz^!pQ`EX4qDe>SH8Ou3qzV)eT7weiYQSr=i;suZ;kl+
zTkW5QS7jR;wJRHSYm63ibF`Z>HmqJfHI^^6d?Uss>p$&Wehyb5<)9O##p@+Cx@g>2
z+;dv#*P|D<mkL^jl+~H0hAATjA*<D!IJf&UN|%l^Q;LSB0F2O3vlesswA;r<G<;{>
zE+*ltCsg>ktaE39&)8Z+<~4wz5We&{?pyw@xX&~W3=+{S?q`1uoas_6KlsM!m1A($
zGx-BJz!aP8xyOcyZ|7q8MlPcfSXxq#WsX4?h`+K-dYSE6KmG)s=na??Q{Eg}WmT~d
zIvL5It5a~fQHZw9?5>F>`rThU((T<NUN(G^A~6s7OtSRas9IlHjup<T`+mRAa7-JU
zTYwtL4Q&bCfLd&=`rNjXJQkxad~wCPfg`bftavMHJa&jt**%uKIohcKDST7Des4!-
z9r|wc>#gS&<fFajZH5OMwUJ7tN^kN!?X~|{XJQO1#mlYNuV)kO8lTta@4P>;$FlH9
zThCZ&@vynLwn0v9f60(_P<S{1P%Wxgmoj)E+tLWRV6X#mX5#=CKnbGjx6C0w0>DMR
z(uJ|VYho4~0%$i4P^A<b{T5!eU55^Bp;#b9O*O<a)QcEKxvqM4zN^0>(-iF6pdCgv
z6n6=cJ_~7lBzQY@s-%D7v7G=X_xjMPvZ6>9c9Wc{zT$y}jFB<Bb_gha2BXBfET4Y)
z=W_pD@$R5ng!i`HUfj&ku%iz<7p`{6$o6kLj(oD*)w{`RYT<IP|C#AL_}swrh-SF=
z6m-^-P7G)X?bSIVm|2}^iZGUBjo^ghA#Q5QMA@T5i6N#N7%Y6Ic0G#Br%ZS0&qV}n
z>ffzbx)iRMhAb0V_zp~6p#tdq9n(WG8IA)r)_7;xh2NX$rGIY%&>9C!KpUf_sa=b9
zXDf}{kJ{y>PJc*CYND~4T07&eubQaNFOc{99MJ-pw!-8av<|hu4+U-z0LqEU-hadK
z7}?*S<O#kFt<hshT*|*%<Y=S9F9obm$GtgIlF{IyS06zs1|$Q~kj^5UEx$ke;>8}+
z4OJl1N8QC$zQSabFOfF{=9lWBNQE8ayZkN~YLc|;b)0~U$e!}^`$AIl8D-Is{EyBp
zplHK`L*9K9%8^HbfkpT)KP=hUC=U;h7xYp-82sl8RRx>lZ-QPaA?1gNpH!WohLxcz
z4gE%=v3PH9bw)xaY>AHO=TueAA9h?0+<nnzX&br&TFakH^HBZdC7pfv)41GA<21uL
z^?MrQ(whAlB}MWnh264CY&BsG`x7q53-nw6Kr82439N4bu`JGYE{%ggO9O?_R8rch
zwX0ibKFxdZXRuQGcD9vv^nH7t&*>m$uYh9<-2AAj&j8{TBDyc=)aCqP&FTTv&=Zi$
zLFA`368)^mDu@uyz-1u+5w#4q5e>APWB@fG`-L^I%%}%Ha!&qky-2EQIHs>WAT+|1
zf4Ly5(U4^hn$Gk<y?zBX8uPQYP6AtLPtEW9qoWyeY!72mT9QGZK5fZ2G_sEameK|g
zg4z9Sw{%TqCC{X^C@tX?#wQzf>rwO5bl7e89QN=dO5lK+l?y%8I2nOQAUy~PSxAPU
zym>!-7*HST@8|%OiJ<B5E^Hjg*iAIlg!co1*9XneRl+)CDw7-<i$%naMB;+2BUnjP
zR4rsdGnk4&T1H4rx81fyBS~ZEW(ZV;T_i^i2gwpYO$S@pG&|!UL+~d+8l-&(ZrLh)
zB`3fOfK@?|3IO0pfHV!{H31%>CXK|y1p~1Ngy85llKxjoei1@98s4}Xznl5xqdDK>
z_kJw9J>s_6T7e&*`<_<`z8~bIYBQskki2W@I5K?aUCRE3n_s@Qx^<@LElQbCUUr(U
zG7dQFf5b&8FF3SE95qCNm|hb`SefZLe6Pe+`gO6QZ~y5jyMvA=tPQNCmW-bq;WsUN
zmyIR*<adwRpd-vT^cv;@9j~5m2p%RE!$guaQtuON2)SH1fCpjy;s+YveooBV0AC_y
zOTZN$4#lQ8C?i#;S>p=3idp2lBqVa0XnGyvHszASNkYqrT>s<@s~EiR<9YFShgs=D
z6TkSg+PjTh5ZMmQ#w;4VAO=rh^U%nF0GQCPM?e909<VlsX8M@6mUZ+L&!u42qo8#s
zlcOmbzM_SK)RZ$B(n4B2IwOHRh$0bk?MW|qY@#CYMSQLi2q%(;Yh#iQc6hU|;!_Yu
zwK8*jkYf@wyf1g6X1AndIEKUAN9u@-cN>9#vEN8S2q*@n(E$wG#n3WeeP%o+YN2*+
zn9{{msT$cOhcFRiIU(kU(qCq#3zj~@=o+KM8Rv#@X}K8qaym@J3slHBe)<drIe-D6
zeIsf@@}A&J2&Aqp5UPZ(@eE!HDV%5TyHKglufPP*QtQIB;$vU${-{e7i&`966(Xor
z>=fy^o#Jw%;bwP!FDKu?t}0*075PSP#=*_O!djVEi^G#iwMv!q;rK88-&=>j-4g4R
z+s7>Ny|G&%3zct}tMUOdlLH7bf`fZ3S&yEg=j`i^{c92SaWDpMzSQ-qYobQdfBhET
zQn`H0ipKz~8-#KO1yK!QV-D!~pLk1?R@DCxTFFQ=Zny-ddnq*I8ARU%FffRnh3l{d
zpvH2*fEtj`ogbfE&@g?RS(j&48W<oxQUTS4h9fz~VJMk<3Z(o1>eazrC=vCWjg&|G
z8Qf2x2c$KuxSu?9&o(fVs35W%)ENYa34~+|baS%UpE&%3&qNb|YK*8+f{X)cf<}m&
zaabE56(YDMTL5Iq8_Q2h)zD?+B+w08fX<cG)i0hurz#O5n(S>lHXQH-6bn}Jd|;98
z6+{6;ONAdGH{6q9H#zn~w61U=gl54^kyonGE1~Ro2@(<Y8V4Q!+<|3;S!lyJ4U}r>
zwThAlgq<R27S0^uvv2;+W8D_58oWVZ@I&~B;}N&@#_(JEt#u2xH5783DuPHj47P5a
z+ms_+Nf*t=?V{b2UiD9;Zy(mmnwN|FaN)<NRN*4M;Ok#xM#mRwUzxO)_l#LC#meVQ
zxi2~_4T<g9%VnWh^);d;MJ8I0sr74rbP|+57@Bd-24o8WYVHFEQnfd?5J1wC^%m0I
z-UruOMO}{UQeW?}P;>(b+$*Spo12?WTHdZ}%{=9xEVJF$fLSqNPH(9<s?Ycuu)wmZ
zsECMapsvgZuh8HvjUW|wz?P?8s<7<d;8B9tFCFHmSiI6m<;1nR3h@Pk6jv<pd16Xi
zw}h1P9A+#?*>k4OJi*+u2{DQrV1q|bpH_ky0>gj7`|&?3P<L*G%br@W*7Ya>D66aa
zM5E2%JO(Dq6=&@8bZATTKv84=PuD+uY;#aK2ukt9gia!RB=B;nVwadnQvl%+h&?9G
z?PSni3rzA$!+;+$RSjuK4u&pe1HeYz$1Y~tG-B3EKOf^>%;57`=9dnFg5Sfm-k5A$
z-7DqShpmhQEY_dhAy;%_Q20u#=<8ZDS7SNx)2Uu6B^*A#4&AW)IN3P7<L#{@;=gZh
zoL|K+cu75GG+d9r#zYY<JJFVchBy2?9f<K<6jPx7D-0z?kAj00&Yk-_Cd0QJz*{Z{
zWl|+VxD7T^Y}x`BO?pQF*;k^vV8}X@M#cY_Bm#1xM8&*D)V36(qqZ`t?7_8{GqC%V
z(j(7CSVdKfAh=Z&%>xQ8SP7+v=~YRC=c4gqP<y9(D7ou@o3uM6rGQD1TwvDA`z$Rm
zs+MSF0X3dtJ=OK%9dd_OQFnc02ue~yN~cfv0uk?nTi<i&&|^X~(Rmox#jM7Tal(wg
zAAaY9js%}xo!t#!JptzkE~qK<vOy&2$oD39T!}#CP&AO5U;xRzxU>dvHxU>n11;9B
ztx7NB;)uQq>_;hJcCQ|BOkS2CL=BqfoyP|@x%zbKhy@xNclO8sHY)n&QgWv%Ersq;
zMrdZ+0RJNYPK4EKcE+5Q9_3GljfjG9Hyzg=@G>+hl(~RqAb>6$u#QCZmNmgR=7{Ik
zwq`=}Ph2!19~JqsjO*PI?z>B~J+sDdq8o0npX9I}z(T3n-XKz&QR-<dk-Ek2QYX}j
zCJ*cp<iR3ThaK7gVi6V!=D$qN7C|*+#Fc2wuf_S?I!BxI;x6c<pJU&Idez6I$~tT>
z9HZ0^F>$&rHggU#gt$a+=n6=;SWrTNo3j_O1QerY`LkCs3(4sK=tQg_L-<T4Vn~4L
zq)Z55sov5){i(ISRG?kAK{r5@&284LrXZaj!d?yM^s}L~jqt{U^v9sTS0u{|W6dJt
zAg+@f3X7)-#f%2aGh*^#-$M@{cw50<S9D{zDw-bwF=Pl4q@h)7CSYWNiA)d#Q0#Y3
z&M5SbO8A{OG22D5U$5mw1;+w=^Alym?)s%l%e|JX(nvbAgo=7%!@b5O3NA`UtI|*`
zY<@(0pdLjA!;Hj0+wB4GJw0dfzFpjJbNDB<Gup7hp*nV6IMk&&t*9cfpBgL@Q6}U8
zG%NB#%zWy8nCFJG!_8O4t1b{PM5A)@BzVE1MGxvCJ)ul9{S+s0Y#{W$gwpFr8~=Vx
zyX=D;pgePE!76Vz4xKYnITAe(GY<%YAkT;%zmdQDI;$fFse#mZ#qK9BS?u*NCr=zB
zbhFV>CI<oiQ?XlYAx6ZWSRxcf_{c8lXD)sk!YW&It02AFp9o*0gI=Zwq-z(3lU+j>
z9CUZ^B`E?9W_`Y+Ju)Z#sH_UFU96cB{VGE&f2vRX^YS8PMCFT^>WAx~M|0tGAF|6v
zBEAQ3{oz7?$H=s>{glZf^p68!KBcL}Y4(h=d{r@6S}6>{LB-0>krD<V?F6Uh76DKD
zzCD$lc_)PfHx_jw^`N=m6fD|7zG0=%<!IZoj(R1iwDT&`r1_gTi0o`kjM0RK6pe6j
zgh}NT04xx)@bGv9IfQ$DA0`6~1(EQSmg>4@B3uXv2`LAir~nlZQY3V-HduiM>b<Cl
zibpbn9@I?(Zbo4w0=d6>gWi(oA6(}kd=}(Na5#sP)-g-7kp@I?xno@(>_`toM=_M+
z5tO2H)=K&TPK&es^{Ix(k&~5>O+ucD?gIU|Ui$DY4|j<9ArZAic)o4U1XEAyAz&hP
zCAceuYX8}o%<k6{{N#Zs(|U9Ts&QViid5^Ml7f_PATJBVoB~q2f-si?MO7^<RDxQ<
zqwjtJvTsl9QHtIBG@>KMI52E(eNdGF`9c<9cWeka&JPQ>UKod=qgXmhNtMm_Gg3sN
zF&c8#;X#Q$Vnt<W@cgE`JU!?2mvgQ#BTeX%f^eb(@ca9J!UBLD<;&2S9%=TY^yov}
zh0SK8knSfN;T4U%!oEX3L_%>K$SCabmK{a>+<r%P6(ZO^0Xp7C*&rMXi5jdTy_7GX
zB)0p0#%L%ME?$aRlTYa(opn?OUBK89BZ@swMaYSWrA&8md>d`azR7KxQMIT6E!*3`
zM>{eCOMya#QY2Q@;N8$NX#W^h^ys$K>muH@{jvD^2)kbiARFtjz+`OZ_nK!_Xi|U$
z)=h;s*n8kWAgb4J8o{99BtEv=2ow#JOH`D<J~Md1r|3CVhvy@%0Nn^`(3pTw+R)o@
z?%#iEMLwVtrH27Bs^9EBJ*NnXtDPPgY(44Ks9axa^scaZT2sKP)S6{V_mbq=#GIvp
zH@>UbT5mP(&&WHd9U3#hG|V08nhyQKZH#cn4Bgt%uUfYlXxGRtj9vJT7NF{ozA5NY
zXi(bFDTTM0i;)6xiuXp(fSwVYR-zH1%n2zdERK@&h+Pi#3~(G}_s2V9d&{F+c#>+H
z5njMhYj)qv7YOx%95)?8I-G>-EpK^HX%V;Ph+CZ9z5S8$!9jtoLwkYrWX&}SG-M7L
za2YCXUhjrLW8a}dK|5K*EyxWN5#Exze-yq*5Scc@puK3IzV*iYb~C_(237+AQ_esG
zojQ6CF%%&bF(*Sc)u4>==;NxsZupDmPy-=Uc0ICd(~f7inAhM$y#V}y&zFl<HHm49
znSMcll(V!Yg_%R=Mogn>DHuyw0lSA5&6{!S%*9zHx7CYahB1dsls`N*#<nY#MfOff
zYg=xnz4YXzq-bhlV^8$k7i}xr_A(2k6f@aBN2Bjio6{!oUzB}PlTHjSPR&X^F>A`%
z9V-3)HsThwR{@GQ+!R=MG0h*Up3ZI$?hoN_sfm8$V(O~zY`RT0ImWN|op??DtyN8#
zzQD4Kvdy0=4rbUiJU_Y$YPDlP4Ol>3L)!_s*g>X~BMZYP&?osB?!l60K`J+Afq(I>
z0wuI*O*p4Ly^)jCiHQWW^c>rL%NJQ|tsw|QUickHna|1=*CRQ1e0^5CHR;{dmp9$9
zn`!-Hnsd@@DucDRB>Zj{ep2+4rdZsYwijfkwS-A0@jQy2Du_RZ#rcWO4WNBj=%GcP
z115bDVGV591cq>uXorgJ-i*GE(}ESsplTtdIRT{&WJ#&(c5HAO0}Qks=$SBleJ@<k
zOL+b=#ngL9L8`;W=mF?Kx8Y+P)_3pum9V|2G?BtQSOPV)VG^#k{ZIxh#^xyxPnZ$|
zoB#;l!eQ(XD<{}5?zze=Fn=#7VMN)WyS0a9ytn>~bR3&mR#Cc&Y*}@!O!>%unJCYp
zrWY4pRXn|x(KWs_aB}GIp>@=JxjJI9uXR2K6uHu9Z54?9edz-Z0xxpa(apPGg+=-`
z-b^v6q<`o*yE=d2`^~ArN<`h~I9_uqtK6(P7OHbb-Q$c+9-B#PSM=PPRFlfPGY)H`
z(ql9v8$Nq!#L*Xs(XI-u!q0~F$L?-8pd55`TDnxCKXW%TU%qeWh|D)D3s#Q@rPP<Q
zOetF~>RkS1MRWr6QU`-G``_x{(pjM*E&2esKa2Tvp2F_(k&arn1nfdR?jAZE@kiQz
zXMvyym8S-&9!YTs-niKQ@jfvRNfL%Ad71Q_&YfQO?}<?GJ4msh6E|o=o_gg)rs-xn
zk5s<ICYq!0ZBYN9&1`|Lfx@YMOx>s>zP5~5da$MPIMKS%yQ7Wevd97Y29oKJ(nZWv
zr1}Pbu8$ZCHXeN_>E^g!?>u~GAJH!mY!^1r3Fs2A-=+l?gvV{!2S|W}?E}^R8166?
z6`&|MItdXX;Nv8nyf8?A?!%J6`tPut8f4k=OqUI|1v-JI-dxmPp{+1a1X8#N%MUz*
zz(P@Yx{UCQ*<_<dOTvZ35V?$?kfU<<D<^gzA1{@6MVc2|#T9CKLva=DD)q&gRTEd8
z{A4*?RE0DKI~6D{2|=Cu-L1*Ozv5COtpEI^>K$sY3e~MH_tsEIq6s`v=^>xF3i{pM
zoA&MEsnl!frO&ZH;*=(4$|)fM3w{%<M{QU`;?t!*slB<lJgrf+0s2dv>BjO~1!lZg
zPZX496zo7EKC`e+kNJUov_`nw5Vh+H+C~?T!8r%Btxj1_#B}YE@!d`>-kS02OWftJ
zQA$YzmMk8*0_;vgkG*dBUi;!iF}L#(_P!h{os-ksJ6PO*Xy!)cxsL6!Ara3c*R7Fn
zn=6zTKT~;7ajbmEx*n=@_`DA=4z;HQ^GZ=KcjC;MuUWPv-tT=73(EJ5hFjNk;Fm=H
zDjB-0XP=9$C>CgKks3Bzz%LC579JAVugKQl+b(3c-#Rr>k$Pc9XZ1=K%LXICckM-r
ze5+lHnpQ=|Bp)(u2}T{JD^!CA2{Hs-8$xOQr7ThSwlac3KrfU431+maC$y)VX{fOh
zs9#PmJz-6;ARVL7Am$rpQ}<wc?l-t+dNk)Sgp?YRk=>a(SawMKxPhb!q9aV%ul{XT
zDYXDv)DqQw0Zbo6(}caJpO9YShC#=-hD6^$OGLCk=mBcEc=>~Vr5DG6%8%FBoyvp!
z+vvq<=Ng@UG{g%Q=>d`!(@CcHr<5eH_-0SL93SImI<s#GmwY;R@t2ckzR9{JW}E%V
z1;TFsH1Kv==A1ZjdQVtZ=wepqvG@&wycUA3nexD84&C_L+pnx;Yf!OZ(muZ7*?XPp
z!lTn?6Q_7ILdseWCC<*280X3wb0(@Udb-G$TH4(CQBYCY>}4EgldJP};cZy7zw`-A
z+)5SQ(3)^A<JXGgovX5?N5?$QLwpiD%rn`XaeJ-qy#wKs1ES~R&2|=db+?A}y_?TA
zV43c)mF(d@6Q^WX)?~F#OCKuGD@B^7Eu-B{S=q5moio$t{R0srcaFRZI^uF(BTx3t
zg@ki%YuRj^5xJ1!6~s0QBHICTM$>9710bbq!C+d-VVVaC2ej|a_Cc-iC?G&}n8C%U
znNoMXKWlCPl>xW%Cbz=;d-=xDdz5@h){R1K6%ac*aXGX;<W*1dG}7Ge=oG=^m<-+q
z<DDh+0vuC@FrMwK!TaL1QiKyhwD}xj&$6%3$CAw?kR!TkMnc}6f(U{N2nU+dtVSUj
zH=|c6+ixk%dW8^-bu?O~&K`3gYs7nKb!@s;1B(2J&hn&trC*O~o}CrG<tQu%s5j?+
z?T}hbH;1XVMDeU8My`%S4n?}0ARZvKEWm7gaqOPM!vdrEp(A@Tr+sg0=J2;MkKx!|
zvQcwv4iCf422`H!^6r_pQ)$lhl|A4^w@v$mn;LuFKD|PtP@NOLVHq<N=S4oP`JGix
z8jAg4Lx!!#Vi~p{s_c!~AgMaqdUR%uxM;Sv(9LqOq(2rCRw@a#n^pW_9vs)NoKvd4
zCSq3Tw(V}0_x|K!i|1#16q%Sb-pah+C~#Z1d}z8b>u19Os{ICAZryg0EYhQ<2rS6l
zeXpEp)?D`6U$*ql(>C*o&Zjd|1AMb)48k(A>|*V9!f}o)-=8<eDe@1qHAQiC@*C8N
zZO9%>6Nt++)ja!7yUmN@Axn8Jrd{$1-1hq<y0=n^TZ+DUo&Wj|O5<}eCQuvWEQw1e
zjRpKEvFBI`pJ*wkN>Zp7kTqd_0dpKPk^4CA?(m<3LHZLwcDV}yhvL50Ol9cgP@r+R
zS7!b3uBx%I*6DwK^d|N-3n0=syuLHjlvK7Ehk-7PIj!8)Np!s!B&=<sxrdQQ^irO=
zuE(Ep#X5UlW?BR0HH1eH7EW)ngRIJ2+~HI05lvZP{BHzjh*wED0dYANkse_*8jDTy
z_qGLfJT2@V+4_07jjrv^0F@j^{1=Z`ex{rE?JMk=D&L!(vA}let(4D;UM3ucqS|oL
z#j83OU6HQtLJFE3)fF>+(;&v9UE+O8>{;!X8^C9-cp~7b$f24t!eR10iH~*d$`u<*
zo@->A&Ph|d&dG$jrzU?~xnaGM)S-RPYWod_lQid3t{m8SaJ$8Y&YQEg^=tCA-a6C2
z%%@y%OfDIk3Z8wZ;K+6<YJwYG$CRw6_KKQnIDML${;rt)+q>$?Z1bUqvm+Du$LYH5
z*Q&Y5H4#*?qdvcI_uv?boDNNd9zpwC{(Yr{`aIjJ`qf9PIJS2__EhlO-ad`pI<5$<
zRYXd0*QkEOH-QluKSjx782@>0RcG-yFXIy3bRO@3wUO<S^Izx2&Do~J{m#F<wT1PB
ztqhh`jmz={H3G3n=@l}Idh6Y*%J9(fa&FY)<4W{-z6*W2jGH&coTX<D_~u^LDX>TO
zmY`0u|GW4v`x(USrP!p*Ms2+3PYfQhaY{(I&J-3^=dJYkpOo2tW!gXXvWv-$4I(!z
zxBqPT=X{RRg-4I1nnbBfjyrM6mI$RJ?OU>UVvII_BAYRC#P=VbJHsu$jg;I{Q17XC
z#-=0MhfP+xJW6<?&pcOCck`RKjS%gL@sjU@%Dvx*i%j30?3BG$?jr8z+H+*2VE*wm
zcR@+6L{z%j(3&#|7yZp=N?F`=EBYra5KT_>%Pu{I(;7#}nu1nnhU3cY1(a{>^_Ci$
z0;RF-`|JMk3w>^7AWhA{Blvek&-_)dm2UB;Tv=%GP12d&4V)<2^gUnFsw-uPQ1p(<
zq|45|Rd_w!sN?80KQC1?aEBv4OWaj8@LD{C2g$iY-U&e+MIEwxL@-Y6XR!~n%`}b=
zgIqMt(|9Ax9@AAe)-yrX5sSFW3!dJOdC%o3^8a%o`KV&-Ug#TkX!cvJ%nH9Q@x4r(
zDY@~Ze^sdPh>s>Pt@@#Hwg)lhidE^?zjmMgUi+-%?a2}Iny4Cq)YtmVAf3~kI!Ytk
z6U429Plyz|Pu^sn`XN8q9)2pQ`s!OVdr=R&sZHyT8Mh4HIU~71`@Lp10{hzg<)K|%
z$gsp&l4lUm3z7U2aJ_o1QzLBM?>A~>^HgWaQa3d;l)s+6^FOnxME;R&5SAh_cP;Z)
zYq6$jP4o@BL!5!12L#~u@GJ_QI-!(b6>|>x3!5wKX3oz|*p5F9M5(diwsrqp7TC5!
zEXnYrN}@rW)%b?-gvM`b+HZ<4vT`zbthn2Lyehrrpiy^g(xse;ovoRv`t6t0=Tm|;
zg=PAN8Yvk3nL%qiZhX4lQQ>wRlcX5E!=Et^lggUC1M_Fz-t1&6alUlnQTFdzX^qi7
zsjDAnf<K05oz1v$A&GNymz|W3C<Hq<?e3HmHi_LmCSK|{)S6PP4-Be@eOmVPWLSgv
z7h&L|C(lgPz16&Z)k(%RN<CSMw|^Twz=Se%teAmx`rh>TotnkEiW%C|Jqr7e?19(s
zgnwm~_^S_Myo(ihV07%nnUh>xTwdnczk?;Vdj+V!UK6Tqy;`8Y^iIwb$!lA~Mc>3v
zHam6qHFoZm;Br&_R6H_Wnz>=kDq3cdCuX6#Y>Aq;T15dh?`59PcwHRW+<*7i2};e*
z=JfZ@SeG=ke*sNa9ltaeFgx*mv?WpSQ_9)Rf7-40uU>te?OXWE%9@?_Go5cMXBg+R
zmBngh=R~5PyR{lV$}`@)<@4vJxBAlQ*Bq2a3bfA;YOSZE1I!6%t6b;Qf#-I<VInnB
zz5`}IR1&{lI~$-o|BltO=SUy#g#+L=McKz@%Y2UPayAY_y)pg35#5PpnU;j#UvcP(
zwsjsQ%;m|4n&|g1da35zIIOaGQ)J6I#~JO>-}SZQ6|y5&8@&5Wv<qD7&)iZskZjFN
zIGZlYUu&Xxv@4i?jlyoG4VD{A3j6PF&SZ@Vq>+h=I{&LN{-~m3jj0pe#mT%#nfCVw
z?oOR1=Qtd6_^XJ5+Wzizm3+NEZzG6FzB?Z9c^c)&sAcv}nQ=2?kuwa%sp-gzTf$RX
z)_WwJO{7cCpJl5&S*b9z&u^7k*2yyOgr+lNmDW|DE>?GaV!z30)tb4bV_C)C_OAfe
zf*V|Kb;efK*1ZUyDMMU8?hi}b3*Q^8g4bVdxHu=ZThXs0v}Q?hj{$@Ck$q|ocM4#}
z!mOtrx6JB&P-}@;;J)!CNp9CBU*(P)%xfO=&b+!1FL1VXFB7dn>s*#>jNPv_nH$+1
zh1`xDU18d4WMS1g;H|uUVA5_z|0iR)zpdBER(`$NH1_KjSA7`mmCl^mn<2+r=b1jj
zC{71l)xANnOXfWNT=g>O|H9$l&Cs@RZn07+8kk5$K{*mzE(r;@>%Tv3F1@7wV0*?t
zpYyKWinN>OAdbK>xgg<-d27$uHw#zF`9J=pFL%7m7kjF;_|+rib&JsTQF&1H_KzM(
zr+RFNayaNC*k4@?4#mu4;z0Yi2YyK((rf#_$6t^gE9)1A28b>1O;`DjH*wET3=dBh
zh8+q=u$*AhlI^mj9IlWk%J1DUyB5+!h23YKzG*LFUNfI-v5HPLU43YG%ip#I!O#Bc
zQN8vD(tJs};L&0=kTw<Hkfb}Y`C4Sdqw8;JcdY74kx!OsJUI5cQDd(Dh7S7#<F&V}
zmrafobVd~>3i^Iu;2F_hx=Q(*?H~O8G;r`^yZntCtG|DI_HkTB`ns+9jxZ5ZMI|NP
zMD;g%!-KWW`KJ3#YmAR0TjpSu8UHiQ1`AWSc0O(P+KtB7$36U>Rc=%@p}x0bO~#GJ
z=a;|Qo@SN}`5EO<p`5kxx#FbK@wUZVPhVCJM>yP@*Jok#4_8zUW1AHHyD4}6>TUPD
zLE;(zB~iXAz2^I~ES+nAxY<8{j|ic5I&UY<x?cZS4E3rN-d|f&iy7e9g7zmbZt#~D
zc{05>_o#p3AIpweRGW)JO^8pa+Uj(C&pFF0?}m=RSvBR^(>J!;?2Lcbalb!mM-j4I
zgYUmpo{asZq!g5)-?pXENPgSxrQK?;)qPc8U9k--7G33{moT&?<JNeK_FiR&pp-3L
z5wb=WN(+a}_I@>T8W5=e7IR9V|Cv~MYVZ4Fr<Z;>wasMRq_eq9_wvU9MW=})CH;2~
zICY5eE$Od|zbexEd+Rj=&Er%2s|dHpz_a6Dn|Ki#wZ4Pdy=lXz!{_Nnl$lj(I~)@l
zpR*M$Ot#8L@5`dg4X=7P{X))7gpu)4iq98+9vX%0#g|$Vv3;5k<cW#ql9g3jSi|zr
z@#aBb^(Ff>x3L#y?gVNG2A9{?mZ9dl?cOC@D=FF6mnze^e44Y(_%jX9=VAS$>K?uP
z7-q;EyuHJtBv2zfTJ_1^r^@Tx=;klnFFt8M!hSGVb>E4g>UvLw!E>%Ndb{M*J^W5T
z`NQLKWX0sKs1K3zuDYS0=cky%qv{S?KYaO<(?BA3zIY$np5#2Q;`;K>`DgbXl>hK9
zhtYidmL=AK*_&w<b6#nQ2@JOQ8V7auq^=$AlTFU|tL^7tO7m1SJs5r{c9!L%XUnGb
zir&hsH;?ax_ATdIObyioc{=_5a_1}$?v%WH*ro^R1!4%+Ru1O3VB{5jcLX)RwMd<e
zIZNZgxi;eM*UV?Sts+x9DMgB12+QRRIQ#Dod+IxHSyRO;&6j1mHmbAMc3T9ymKake
zo!#XRmJg$!EAL?}6S=&H>#3Bm33b%H-!i`8SH>IfWiizKuqWFVXh_0K{3(T}8Jm@w
zpXj1!PSoFcnJeb<;Kh~UoFxu~Ehj~8Y^KBJtnD~1vOR9sQe$1e`&kX%m-AM?c2an(
z9yn^&#z~nT_LG19+{CmwQ~7yC{zg}MozOJa*eVfE#gh4fgl)_Relq|xpO&6sju(}3
zo0sy<UlyoKsB2T^sFrUHU}Q}Zvz8~@C=cU*{^YkYY}=0zibp5PHkW>gzIMPOz1ySj
zA@gB`w7o?X_uIzP!%V&Gx$Xtz1w2_VZ+BT1&RQhy>Wsll*jiMF<M$6p+g+9ydcJ9P
zdMiF&w&ygPUAHm%f*xx;_5NId(+|tPI#bI#e`V2u+3Ko#b^FqJaJ7Pu9N`#GW%N?W
znMxL;dS&8AzNf+>=C9JeJ90~AN-<?_-x-;r=lB0EXV1w)|3_%Qe6apMt4El#VR!aq
z)$;54CSEfpLpzJ{?@}`VjCb_ROjn0oNqf4<m1C3j(e>I4(Uz-~f)~6)?yotf$@d}S
zqM5~tV7vX9Oq-Nm$MN!J-9Hz+o@TvLK-`*FyO>uiOz|77+vK_DsY%fPAn#4!dd}Z|
z|1V>#Sx5GDgjBLj4I+iH#2{%QDqE<8p)6@*EMo~16_K)(7L~0el+h3xTkDV{CRCF`
zX|MCVzWLqf_dECh+~<GJ`Jcz*+>d{cxo`dWE}zf)^L}5;>v~<U>*)Fh^*?k6ZB_LD
z?oicr8*=G&57*Cf|4!x6nvVgy-oCu}V%POG9n~j(a9cUO^>1gr6u;MWP$(29e^K;p
z$w0OdOe(9_{_3FG)8fzeUa#Hu8k*!(I9he=x!R}un-UFAj|&Uhdie1MMY={)*M7hM
zxvDm1YH6NZo67cEhsa-7w%_vdEBS?=4xTMbn>7BaXldB2^2@J^X8oGF^83pkdajk{
zWx9ihpS-MJ%Z|#oW<7>b90JZ(NH1T#_SgKA;lchlTkvPpuTXgHDgNng`FswdY(dF7
z{#Mbf`<D+KK65Tgo#v}oN1^i@1K-N=&-1_K+RCT5{8o7ZH+4(z4GvrhCvDHZeTQ!^
znPX(M8!l1!#fu|7{F?K+e$)P}wNiLK^Eq_rG~-0>F1c`5XXevY-_wlwW4m2RqbLm7
zz^EEIbMDT?m3=B)ZtU5;8vw&=*@b!C9&NhwUBbfyj~+hE1a)*<zkJ@jBNQGqj(Ht0
zj*B~W>RXCLk<Ygb9XZlO(CKoDT}Av~#m3!o7uytxZcY0S8as9Y3go{o?#5Si**h7u
zNUQ71z_A-=G0WI{aW~bbQLkPtA%q`s;={fbuG98Cdhj5FZ?lcDw7oFzuW}bNID5B$
z|Gi}#{J=LW>G|BVXOBij+=Jz55YNyh88%Q&tuk`FeB*Ch<*Dyn%uR-()VWSC;G$(D
z>!LMk5SpqNE?i(Y<Tuq$(^2iy$6EXOl5wxQKdOu$mw@J(J@V};Nuo|#27R<u++nJD
zur%kZzL@RZxl0$Ruh>z?bAk6zYtonR@_aeLv;FpNX*&7kE~>qITP-$w`Ss4l>Uw(d
z&$5;^ez4w))mJpX|K40LaosbW2ljz`AD6=v7^0~eao-~>&q=Qw2^Y<wLuXRMIagjS
zH_)v8>LqQqce|Ejz1m}i!m#|$Ro~Co>hi{TVLDZ0=|#7w8hG_#q8}~lu3P?+eQ9V`
z*|u}b5j=>Dp;w-pEY9wwxOsbo$19U@eGY{Dc=TK7@b`wfppAcd(}yLI=-6cz%G)})
zwk+M+;q}_lomExMR+p?$+zggCQN9x%?!5vh>viWAchk_+OoNp6*M@5j!Ho;NOCk3j
zH=U^y0U`>x_qIv#u+7J3orOky2Hi^QPmT96xN!q(++ZBzvkOai-AYOtRy6KfPLx6Y
zhXZ<>KmMf~(N?a$^xK;)CjMw`eS$tajp(eR5)(zg(BU4ZG?=!L3X5jg*y~wUkw?*!
z3`Gsc>d-UZq-Zuujw-`OOwrl!OUeJZafqUW=@ElDKCoctP)s|NvpVtAr+`^!LBLN#
z2}<AODDT^L>_P6=icqT%yZggcj)oNc<I6@;Do$On=EgwoCf{!?l2R9+uF}xZ@J@am
z=JW@>@w(^$Bl0v2N%O2Yd-<r}wlyxqM2=36?^himCehGe-EAj3<}@<1<t4c`fUePH
zGy1VXK5TMA;e{ekXcrAR^&M1{cEnQ?1#)#jxx!ORAse0(Q-Ho;JOozz$nTZkazI}U
zj;F)BTd`wq-@g4%#$)0>JO96PRTLJURo}=<jkD!}F1_@0nVg%_tiB5E7M}*ozXZiz
zXfeLS5-Q_SAhbN%>T8`9Ej9iKlz;SmHbr*vwH)nhIqyqGD*C+}?$K2K!M<lh^Iq}`
zKc0#oJli+^sxVZ@6XVM@h7K*?*j>@V>4<^SCdPQl*<(4-DLDowtk$ZvqM7QO+44R^
z#{u$~-Q5$=wKH9~@b51x|K*#SaCs_82X8OINXRX2YyFQaZ#1Ct5&x0x?e}}Po&D2v
zo+foyXn*sMw?0)`y$rZi7!UQ4BU5vO6^6!(>zm1^rGGCwh#&PqgYM+oDhwb0+dsrU
zR^ART>ZkbEuV;DvL#EG|QD@a$(X97B-I<9+=XU?#0!;kT+}sz|LWs9_Cl9}-iU~XZ
z`T4--iAID<wQJX!fBz7YhGTP=b=#RZqlstGt=d)!MQMYUugB!+m}$BAfaRYyez~@m
zz1aB{nEGL78u}*<H#IiyckDq3qa}uDXiN{WGuMl~eAyIg*<2^5GTo>iio!w4^T<tA
z!r%HavFgE^aFv|4Ne8ow%@-~_e!{)lZoZc9^sij6WJl5?{f-8NK{s1?YW~}E4}>4E
z5{~h+ODhhbuA|X={bGmTAns^b<X&5-eFJh2k39a4>Q{z2xBFBY{sL3*<EC+D?l+q%
zO!vzQY~KU9%npIs)T*Et_A%y_xjSl_nmJ$RI+2KZ0vEQnc9o)E982CG#>X6rn3!*N
z!-V&cO!VAq<46O-b;l1IHd_vON`CyC7^}9x>ZlUgu2}I+`l(*>L^@38^3Nd68h-wK
z>BUF7Gv}H|n8A}hhXIN<a#M8B_;X^5mLo)2j{+A@vi2Rk!*rBAR6BP3>D~p#lJyv~
z?o1!o(g_8wadpfI6j6WLMh-q-eTB+!I!pqJv@;Cq3T9`(W?7ddBZZ_t1PZ`Rs`K&h
z<BQTE(CL?_&!vpEd(CsS7s`MCX7*i3me=O{+WC)EnM7|uJjFO4e}BvO)pYi!(})rT
znRw-$ecjE*zoiZ|L{HCh*o`u8Xy@jO8A-XN4BCkuMZNp??*00(!41ZAgtW;NjA=Pk
zPIAA)^CHdb3M~>-;rZc_BCelww1ou@hXnK}+QD*wVtZ5eK+6%Rd1XS!OVRJrrOP1B
zJxhppSeK0I;kQN_+S-{kL`b9o=T3L!V?*TU^q5j1%Ctjm5*EreopAkVqz?~Y&!sFB
z!uC0;&tY+K^Kd~!N4Y~(b3rB{1N9*z6ApYmf=emI8~88c+_`fTi)p6Vul#_9+D{2K
z{SvC)^mKe4_u-W07Ub9>p#2URG-wJ$R@ME9fXe>k-QuAlawt~Cdc-7)g=AM_%1&^b
zXXy_4VZ*h$J=PoLwEl^aH9}7y1Gl02%{Ox+*WbT?zjN2FXIGrqeCNu8c8Ztx*<6Od
z6g<Cr2_mUm|CpTBS=4pUpxyEVw8%_6UFSZ1hz`um%|k^0&%4Yov34>#Pg%5K1o1Ib
z*fVpNEjxqzy-ay+=)yQ-*g5wfJn&KLJ>GR5^zu0{&vft>Iqo&Z^dCQlkyj3BXeC!&
z{a}szY54gmL}2_^;G{w1g)FTF(k5;ZA08baa~d+7J>4^M*Q;Svw(YHFs@IVJ^O?QP
zE7`{QC60uuc{?b%lTho8#<9p&YukO~57aaK)EsjYte7;Ej$@{UVYKtR$G=tVkQlH-
z>l2$^wUXyYBo>yr#P`;%iC*2mn*wh-+^1R*6oq;A?C?$BzR@DovSk&NLd?5QT7fCt
zJB{tnZEbC<;RUm=aANAb^Ug*sH2h$}rIqF-#ZU^&L59Wq49!RO7>W4u%mpcq28RwF
z3_>BL2*BHT`Er6%z2Kg!<4!(*WS<t|g$S;B)XpYfH4jB%rW#sa87!8<tu6Y*6{_kB
ztrKx4oueUP=u2?aJWQ}sC7Yn)>mV?pJX_B$hXG1vMpSR+1`W@{h`3N+li08TU5dD6
zp6E-67LZSkTNA}v=eXTNJ1oI|I5FpF^9^eczikQ=bMrw-!wD}nZy5O`zn((~qSa;Z
zn*93qlc!86L={ByN~e1Mh;S;YL{{r)$Pj|EJeQq|Ly@YvHKyIJNwlzBbE<D1Z*aZ)
z``fo_?|&{T+cd5^EwKI!eL)bwSEr(^ld_|tD+<Gfbh@QSyO(RmK59ktE4$SczdxOF
zTj=?mH|?+Htky?WY5KHjp)t>R9815(BN7pX({3_^021}EdhHeyzSYt~EW<gK=UbN8
zP?JbBTYYb~`zb2W>X^(~XFpwxs=#E01_c>jdA@Eh#7v94I3`P!U55!v*iQ&y7S}48
z+a;3Ou{LAL1=H%iGQTs1r$M0Ew%2H5XvSulDK7##h$C&ec-GmuWDV(P*$~NS*17(@
z?rJ*HYV5h+hv_yow3<x#aHLJ&*dNo%HV$by66M_|T;5@bM9|{z<*f}x$p(hEDMWIo
zY{x4FbOa5((tDOIG^kLxh%)&j4T`9SYvm}FNyvI;&?@Fyl7@oq(D@gCfUQ6TAOH5m
zmis$u+5gY3u0M+(F|+funKy4<|55||f=El^{E!k%)-7#)GHR)~_>+Iryp`%vo9w|n
z7hA~~HvUmmuA!y1&m*R_B1_R^ydubwBKJx3#Ea11iJ$@=i7Uy~_>3JZSmRN1Z26-T
zk;Hx$e=@bN{rE~l6ne}V;RMeym|)km8xpQ34Qlh+yHF9o|8*seMqFx-ahuLV+sa$_
z7JCe7)PW+eYC;F{xOTfv-x}7PCy)^NvwOGq5`>4YeD(Wo3b+CEs9ybA7w^$y#FFi6
zQf4R&A4q;^noYA>G>M}<6fLZbtc?>RZ4el?_Nd9urQdJ7SMRargs<V}bsyp@bQoIJ
zedkG$Ju1vi^awUc(wRAV>Qqg_pDX_3wY6uV1RGELR5_>FFMEZ}+oVcZE%pp{T6Zlc
zfB)0s4b-eH{73(^<f`LrFh53;M#^r!`|AMRN(~7<oae$hlCQZzr$NG_OiTlwKb4wI
ztrf$DjYvv8H9KK-<Kjj$IAIDpi54V!@(wyKEuh9~c72HsjWrY`zs21kNL<lb`|_qn
z^a4}UGjgj4T_-3SCWhKjAUs_ZbuH??PXoq}@5%2o!^mjP^yzyT9uULm1AQ7cElM@G
zD8<SA-Gfg&p4!(<NSLzgLPMvC*T+-5FG*Dd&AM25O`(WM(V5Bd|Gf5&E#or+88muH
z;{a4iOLi8i&Rm9omwX^JD8dXGZ`crv$#Qv8THkb6Qvb7QVaRY29hepEJlW^K+51a*
zlB%(pyS=<JApU9Yy?qK|U?If5(2un=U!aL&<#(=$b5A)%o~ER*@}O2<S-{))w*YA=
z^YHsx;oL=nU#8uul7}sB)9K|BBIL3Zn|c%IU02*IuH_amAuE6X+x+|j6o$+|0%X_r
zt$R1s`^=hzswo4e>|+4i+cKy+g%^_hL}Wgy$@5wn?ZaA_!c06yf6!TIxqdD@S0I4b
zV^4qskVwDdAZ8$Y%^pgy3~RG>w*+Y~ZTh&p>+cK^Roia{U4@sW1Jc8<8JD@>oudDs
zfdePgd$DeGFNw>}oIh`jIb@~97nSpQVQduyP>#~)5rZ(d?egXKS6^{p@5VD~-kFW7
zkDQs_Pp`JaHn@zsx<1tMeDh&`hYznLFtpE!kFhynv1-*hnF9e#@FTt0!O~Il;OKW#
zi3h#q;o7mV8bgMB(BJv^wlYK>#>0a@d{#U?Oz)~|y%eEo%3P>h^So~~)Q1fD6??}|
zaQ4q?g9h27S?T}Xiv1F@6+gc^mywiSC2>Ro2i(gB=zsYA8_DL>05@|ak3nPB$Hyla
zLe(Rm`oHl-G3*xWXbYA{p8x6}wuC)%c0YDJoQ@iT`jq^2X7h4#iG3pHU6_bgSr$6-
zF-(q;Q{}COl|r~MI5@aKb}MJwra0cXLYZ*YCZai1NP_Q|VP8%<YkXF64;>m&#k+%C
z;Q4*_w`$)$i_koZsKSAhB#HGy!Ujafb5K$fx64Jm?U~C&zTmTGQ<g`>XB_tNDIj$8
zQHxpmWFqo&CrM!F2+vLl*B?5x_*9+?(X`Kr6WY6yPSU_(I+~#hSq_Au)whSapQKBq
z_vp2T-i+nabpHF#IXske8}vDEhU({^uF4<Z@RcH}Em5T>M$D?%aTWX6nLgGc?j!MC
z93w``QIvkB%jmsuT5U7>cua7%k6t|#3u}g59Cl4&6G?Bk9{aOte;9YNe(^I~D}wC*
zIXgXq^HN7BSKBY;OAhzDPkd?cft=M9tQ0@nRAhICoICd;C-auqxF(9O$+g}6$5+1_
zz#g<NbMNEFsPB_R(e?!Ml$g!DGA+8N>DXR+N^m@kJNw|@Fb*&xY<InR_PaHTiDspL
zq$}*VgITF0eMt{h^bsX{%+P?~PagFa6d@+EB?a&s*JpNH^Le^tPB_X?B3J;Yb3TEs
z6fN87X5`kQ8BoL#jwd4c%So@!s+}Uebt5>^0=cdrm|E)N#w`T1(wXVw>udc)zXRSX
z%E-%SgvunMjPH-l>~ml$@R*=|f&PE5i7BY5dq6ZD7k5O_*YIvXC61Wzc48bOJ0zk3
zY{+rWvZHx!&;I?NH*W6gL(WML`3z}TiRh>>98)$*(Q;NJc(^&Y{V45oQ*>s|-Ehr{
z45n>mhWm~kJ1%AyH%avFq%gk5VsyB!Rj;iuERHXIq&EM8LgBZo>eBlf_qaJk$+S|8
z37AE2M9^$v@~WiMu&^^{wy*t4Vcf2+tzuhGF>V~FP`1|jzS@d~gWf!fFRsa(VrLgd
z8K!)%P3=Tto0tu+=Yu%(khk<z8X9r{uv>sz#kO{zR^*f?t$n?-=jzAwlLX`b?-g&T
zxi${;v?cE-Y;G<nYrkb?T~^bxF^i`Hbn|f|Vd27#)jbvIy_L7x(#UK_Px7vM?Y20m
zDIQ;W#_t&F<S8jVnO(1TyS`-I^RKuXJcnv7xtrt|G^OSqVSe3eOBFy9mM(OQ7?(p>
z1%k6MQf}r&eA+lh(Lv{kK~eMQtO$bm>RW9C+K+^FD;BYUFfic)DGe@mdoP8j=T!Of
zy@HnTmm2Eo#y|ZuqDg1P!saZ_Vj3Ya@V}C-y8X5z`SlYTAvB*qel%QVOs{tHBh7JN
z09R+jn<(N&%gtFeBiUxBblJNjql;qgQLbSpP^FPK!7TSh1{B`Q0n}ppbW=;qa3s)o
z?An#JBv_#^?JH}it=x&*Wg1ZTo&9mRuwZ~w7dl<H^S?Mxs}Nz+<Fi&oX0%e=%nwRz
zVwgj?$ALY#_`*CjBMjN}nKLthON&dq0R`=4b*{-~;iq)hUdLe)n4gljO%#v`e8Ydx
zmeF6`v|aKK6b7(mqVzVAuboCq`riX4-|!D?G6B>l?D_|iLJBWm!Oy=#rW*gc5xVLB
zhI1!?1q<<CF%`ltM_IHn&V`4GeL_fu{`G5DDR(<}PdF#XzY#W4naKby(^<3jYx!#0
zR4nliIcFY0bfFCto~uwaoaQb|7wr^mU*o6R%AcTX8j)%HX4u~dcff@V0p_K3(8DXE
zh2o}<Ealq8ZF=+SpiXRp`wt%`6t11*&4r?PZ92f2q(xVb-oklXS#O2uDZo#`B@j>e
z$*lh_JO9>r0#pp_F9XX){V=oQ3PD};l%lT`ho}A<DsAf@^5wR>yZpW38a?Qt=voN+
zr?6L%v)1NI>|sXeRa(0CUzb6-%e}o%u_M@e|N3vrd`cy$pKDW3&70zd8y8jnl%Fs4
z5asVpJII$XzzY%14a$T2&*0;onX9&TSPwWFFy74)+M_YvKQRUP>o@H8k7=faJ1R+~
zTY6&%@!;-}7?x3wa~1tIbpR&1Ll$ixbKgFu5zy@VW|l|8slCq_(HSHTTW{T8zpVPc
z!F|>DGv|ibk<ZSgRk*@oD9F7W|Ch==i4*9y6S?z#5g8h|XM%g8$I3f@y?v{xshKkB
zb5jm9`;WAD8b^!*#kki+wUs0aa=}zH2n3X-yT4BDr@#i&DN}ZWg(uDc$V6+_k}jks
zEfg=q<&xv%k_VB&h1eCM^nOTr!0b_ozN%>8kTap=uu4*BhqZWcO`718Uo~loD=R>P
zQ@mjF8lc@P**hLfXNWWN4};9rUmz7KYto@sxmV<gr7>R$eaC9^Uo9ie$z*+d9y)&f
z+@F8W+l;hE6F=p~8P;`mW39!iPcCh-pgcE6t$0@a*>hgx&S%U<4Q}<#pz~9Q6E&Zd
zeM%-Wao>aG*Zz9YwQZ8Ilao_S^gZfACq6hkU(Z?nc4tighr?BFCnwijQ(<FumW{P5
zxW`iE)93#g4h3BJ@<0AtMD+`r`TtZ*Yur2s1+eF5E9jX6O|aEO7PgnFDwbYi`JS$l
zYzu3dmt_ee?^WMi@!Jk1EFb#2fNo^McX^oCIvbhHne!{AuncjADz?922RW|)b^x=i
zHU`kHs&*jxb&1I`{}7ykpf9rJTdoslseMj)2O2V|N1#sX7iYA(G(>H=dj7T{m|UG@
z3q`-mCtn^imurS}weiG>+Y(ba;8WxuHl5!AMBMn(gxchnU;jh<_2o5!d~a2(5M21n
z-@I(`y+>DqBz9i@x_e9Vu6>{G#tA_d)gJ?KQo?=O27HuIb(ggdK=KmKwOs^P{4pU=
z?TfuL(@dFPKx;!dTRSn6+jN)P?1NeK)YR7gys?#G<opEJtC>+&5p2~360a>@d@^xH
z)2K1GYHm9Jb+_Zpqa!C{|C@YxYYNgrfVL7gtzh>Ze*ec_RCI0GH`MdlqHa5JW}LEB
z-ycJprLO(W=<C+eRHqVCN=M9`yZTBt0hVH0uP+9PTQuGcpz*HYY+xqLQpy>1mNYV9
zj0?d$ZHh2226(<^U6rmYs1qp&P8Lq@C5)XS=#KKNtzGfsm$g!e0s6=9{|hVsA8gU>
z1oUr8I@vFzDvFh&7@{yxdOMSf<<5NN%T739`j%xtx`&_1X@mhp$$E^U-w$kwp!doW
zu;E>_ioDebzj+x?&8%KKYzn@ZoD-9Tc@iVuRFU5Fi?`=<TXqMO1*!eKv3r&jV#si^
zi+w5mavlHvwV2%u*3qfD42a*kVuLZZP*>NCkC4Y@+=j<xyir-`=qK}0iVPY)8Aydg
zp}U6z<!q5tXW8Y;`g!)FSoGz0WgY0t@Bh=s`v2G?X?9!!E)eYdDJc<Uad!UFc#g=y
zS@6*;7dHdbdGkU^@ExeQgQt{l9HV+9B#cbk0^<DPc74bHP5r&!vM0IrUFzDB<5U3}
zV8O&M6TzMl6sSe}K8I8CO`M!AlSc&OPYb~<eII;|J`hddEIt}t>2nOEwc;x)9E#D~
zngeW^&hU)jkPx2Q!{~BEo<X_qROC{`$wFSii4i)gUAh#;WLbZ5phhwM-5T9p_09Wr
zzR*+*g*$T%$KxEQF)ARP&a!BksmsJG0af2T3XG;^ZO^<*iFBOYZwIImCIaLbSPUcX
zxVQY$5UTT(_9OQbn1-Wn<3G}N`qkuUGW!_EY;)YIz_Gc7UwIl&@`&h;Avn2DRj3W6
z5kNFjo~GG+uB+>H=|(IsNSn%B5!TMk#U&mEmvfZarRK!IlUR1U&ClEWj#L@YuW<g=
zb-~Q7js`}*@ccE)aYJ5=-)!1W5jwE!ivJ{!uR7dUmO)>RBEezPHJoO}B1qu{s?c3@
z({tTY5g8zvu>#rhJ+bBe7$8dgn7x$&RUi@;s4lwJTd?gV@m*ub$E6l+x?zpavvyjD
zwZh($Z$;E@2EmjHzIh%KKFT3s-_VTuRD%fuXwkN8qu4&Ox+k{BzBP%5LUD7A6tdAJ
zn1(^6FtBXL+SfA3%>fh<fTDb0^n8LP0WRsOHJ1kq7%Dgh$mEJ0KM6(%bWo1^v)|ay
zkeCYx8&vHUP$gi@`jF=r<jKiv?CrzRIz9=>d43~q=y$G|#9rR3yZn!Cy(w)=WdI@e
z!~Xu^9N$8kn)C0JWM7#r6&R@&lUZwWj!_axhX=uo)0aI*(O$|Xv!_6{XYbxL;NJ|!
zG7v0S$+YN!_bL{qrKMqlbeZf-o;s60*eK(-xJp)A!J|F<yvUpb(*3*T?~tZoOhAs@
z-OLl?<^#;$_-lO&PveOm;yP#M75%_sRX(6&%#3$nuUFFK*tK`j+R@sZ_5D(Uxn#+;
zvD(wY>;Ttg=CXhye5X0RY{8#usu|=kpS_hfslC4Gdp*9wjPMD1NjQ9v+}DWJXCMt1
z!kz(kld6!c2<cHoOzV#bqcfr4hSXs|SHK2klcVJD1e!z)<7z2&Jip>y`pBdHlE_?3
zHH~BMM?OW*>}im}A8kD9VrVqi#PIS!1g_&+`Hy@|yyRc&u1d|GbSrl~Q)In!R$JiD
z8M7WlvkZ>U=h}!oDcS)aM}SIE+W%E;2=yE}qF@AOsGUg62uPDg774%-MZIq}xv8IP
zTSdRlk8{QB&TWkD6Q5q&7|nJ~zrJ~W&f2857H&6?`Fe+DfCZ9(y670$E?f2v#g8;#
zSf7A^NR*FE;752rEGg>Qu_J!MGB5C+P2A>1c=a_UxmbKVys_T;H~W}(e2OA~11Z+@
z*|TN!NYmHdtHu|@SUAjQ2`D0E#k+SOQwTjry6cz|Z^q)6d-VkgJK<5kS>R?VbMX>V
zS!V%=?s*U7e;!nmGzYbDcAB4*@92oL<2&yE@kcsKzdm<E%Uq8rN^*RuH&Y&puI+yq
z{d{4(Qy5Ge3P)sph_{yCYBOvls9bz;Z1!OmYTrJU$oZG1kXdI?;naaEV!x&i;JJ65
zM0mQ55uQ6Li^@<f*(_JBgmv*Z@JJxeD9_HVH%Ht6-nO}v;v6!y1kRMLf#vj=oE1pz
zP|`kd(IP3z9Pp@JO82FyzDwC-6dKGdEiEI94*U9sW7zzMFW!dklqz*Gfm6Xps1!Ys
z0>x5-sZa_W1-bRbxhP+q;YtfR^cI(9xa9zl^-~!AFu`>B1DG>{dm5QwKYQq`>~}V8
zNOYDaV6x=dg9q0%-P2cqAtyBE!zrQ8@YVXDpJ1EP1=uQFQohk^gGyqo;?|yIB&#k0
z9Rk7unAm5>MhZyEFprfy3f0(Y3Qyz7jYqRFt*o56Zrw#vR89y!@7*<{93L3~#4ys6
zl*I}--s&5*I5T2C*r3#ZGE?H;?|7LHa_3{`FJDYmIJ}odZ?N~(SFSyeZH2WRIrGvj
z>m;Oq9#g(^Vp0;g6!YX~d8@&kS^W17)omH`hpg<j^F4DzhBEyWvQ`?#GlMKcYNa^H
z!nCso0EE;7+K(3Gk_OTnXpyLzJGqSOLuqR|bD7N9^bvJ>3TjJ@cchGyJaf_Yn$J#6
zqeLl?Y7Sa77Os)-+$6om1%U&r?zd?<o2qx&&xWV;^0pHdJ&bN%d-A@y!kR!y^<h<>
z2c1>2X%VI@vAvR=fo=(B{060F=n5InzN<2MfBn;}96IHz(TSIH%ad|rxGSu<C!qW9
zdcNIo&F$npHUUNHXzQfm=?JdC2`>z{I7&Hef=5Jk4}56cI3?;-D(Xcuq{7cK=pqOM
zizqa8?J1r$r7fvzg<m&kZ@?^YBC4(<hfJS2D#!GFC3iW{h%5c|Vf3pAjU$!ro7OJ=
zV@J=DI!5|DX1_=DvY9)+p?1C0f~hxTl0s(C$j;3azqql0(GTZA;UmUnEeU%u>nOn<
zyYJwzmkiEK!`?$YC|uAg>{GNOAtP>EA|!TkkInlP#uiU<!zDjXN$R7F0**0Tpojqg
zze2c^r;hxY=6Bzvb=4qp;zZanUOk>E3ytO4`32MCFu_Gg@X0wT+htHYK}udr;UHw9
z*Dg#t=C2#QT@$x4&r-^~_pOR(SdCg+M=4mH>{uY`@rY2ZOQy=>;OhJWKZp4^MNu&v
zs{}S`^5c*DnB;Zt$dMz{uXF^eORX?pY@W>6hSQuvdv=fih^0FLJVZ&walm8x-^Bz>
z-QVj8Op=tG$LB9!K73<qlb0>ttue!!-OOM7wPXmjl8g(dfv*bT^cP6o8XM9X=oqS_
z8^E^IE{@N7J9$zwjxfjH4*M=-1VEcJsPqSn+iZeTk_n}wK3o1CQC^&Fp_e$gBw*u<
zF!%-H58-~W%S{N}IE7}56JHVT6wpnZj)F}Y4}T$6&kPGn1Y{#@4=4noPqKmuYWEyC
zkOjN#B*!fru~RCU=^WKaDX+zAjHECF7$L`vS}G}12IDw5(vkNA(>Qx_A+Q)MCQR5$
zBoz`^_xFnYJIrk>s(KrkMJ+&Q#lv2L^9#EHP7#+D3{+A?fg%f48~ZX{h3BFv9ubnF
zX}8xDM%v4bQWWN*nW;4@KR@4&kb~CZ1DBbme08CA4mx?&SmF?nguBC4*p!sF?!Ep{
z`T4!i86KzuBfZ6ju~p7;24+zlHsOnfhV+1@_UHGntq628XKEYK>91nw^ifNChL;pX
zmc<A=fBx|m%hctU3J95Hn1d-;G}MZsjfph@f;GWbQXe)f`g!GjN;~AgQeEq|aq(nZ
zfM+!UZL5pdcxXaLWRuFaD$KcdWq)6TD8Oave4)?R`<<b~+mQPFV_u;{Ts1R5&y1&i
z=)v-cvhw(suw4DrR6BPT_JYs*pP!@TN*QoVJaoqxWODS8^m0KkM#^A0XhrVv@{0T%
zI7+d-wKCX@@?}b^+vbgGO(q(jNiq)1nqAO$Z0nf664w|<_e{#y$d7Jkd<Y;(+_$h(
z<WRVOJQNtpeZ&5paGO$oa<a{#I(vs16fK3EQ~c+JNg(`EY9};sqBk>T^_7}C+`Hq`
zi<23DA$42WOFys68Uxo@Oh<16cLL?bu#$f!O|mF>qy^m*S1$Rz7<N>uU>H1Oh8eDa
zqjR=(bb*D9TQH|Sj6+<_z>tkVg9In0W9qjNojFiT;!e$|_p%4wlI6MtCu8$}E?#=>
z)0UoV2>FQSqyj2O7&iBGF4`Uj%#OG2_!CAPStcLoE3p=8T&Ll3t)x(7mS9cg6v-N2
zGB57#@R1|)@&o4pjY+Uh>S0cdPx6rXZhgCD#M5NNVLr#c`M9~$$<UA&6=hc%rs7G=
zk~7LiRjYQ`1e{_Yw6#fApC;qimKRRE*(4oy+{<V18f$-6^bK9`{}NutWXR8dL`>wL
z`~AZ4sJaFv!CuZ!ePj62aw0q(Q;GI%?{^lU$<Rx%w#`bXVb}rbJZ1KToYQ~%k2g01
zIl>gsb+-bVBpAi}nbjP}KwVuJrEy?vz$_yZs1aW2Ey3aiin*>#vO0W}CoUE9!WTEL
zVaG!NjAzraTi$yZri6?+gOmK=g#NW#RiwD-ocnYps8Auj^n5e3Xdd_8`1~YeKEtTv
z`H$Otk!Wwh`&tx#=3yz6IV{u~uf7J>koo42-7x$s3{<G{4&bE~Vn>!YTw-3mdL{OO
zKzz2m3G?Olz<K~>H@WrFOO46)%|Ksmt8ig<K~;K!9+f(!b&6y{NzB9|hc;A4H+aKL
z`j>Eg2zm8JFUikQ@UmbV!p$3?<e$lfFqu?BQwh@1dpV1{)X>+rLKx`;MW}&By!?}6
z*Yp3qL}DSfEloHwz&NDV{KvUpiIflsuONZB)>9RRi{u`1Znl;_fbEQi+E5@VU`l=}
z=f>yPUr!R$N{~Te%>~u5a!l(CZ<Nczi7tc|L3o|u02SK~j1wP0;%$MK`!OxO&9Li1
zTz*k(_UgH0+~_%6X11vqbcw=*8c^;s(1;=-(HT_)b1o}}37C>FkbRmjS#pZuRN+Xd
zPWL8BJ3~QN*o%^DkqBRIEYcUEM_ZnzNx@Q$$R%`a<A%8?K>?|aR4(9D8S_yPLUc$S
zz53`|%ELjYS<Prvj?*CtnSiY&D@bryg}EUm5FP*(2X!NX;f3r&iHYsC05-NM;0eX`
z2n0`r32Aw8nbFnAucR)0(RPMSZzw7*NF-CFUV!xq82!^k@6JTv*aA3n_lwH!!<>VB
zMlK~*wLGhXqQfR7h}8(OPRzWL>mEVHt~fW*26jYgWH%j^Nix}Yprk7BJh0(u80!eu
z)gdR|`B|bzqHrn%9)Z%pps+clOTnL-Br`(rFdQ}^m4CmW>Oc-S1*R<(2PRjV`&t<q
zFMyp}F^|ma$F##4_Cq&%wTZE=^iU|YmGv@u1f*U@(k;ylB$dKI8`mdy1ipt5F9NEk
zFzvV^i4st!oR4PLRp^O6Bo#0)Oeur9l>XKt#j0Xr=~{-&0u83=1b@mi!Wn@UY9f~(
z)hA8I?R7#!H)^v#3uf0siFi(wr%$|;j;tC8Zn5|40RsjA_V=^7NvSvlm07_72}eG9
z?LBb7;$I>`htIvVx@@@JjB=6`D}R0}JvIG{&KlH(5m-sxnosl@yMd9I;#x=J#NW%R
z#gMy5L<%@V5|$s^5%cXOmY%$LC32C%+~^IaH1x`-QlI$q{;B!vtjc3Z?%H4*3)_9E
z<hJcL+)#*|#I(AbN*9rChruy@c4LbYg~JNjkvm9rJK(<;-9+{5(<cgPZfn68P#br8
zd9#Vw9o!nQozI4n7m)(dA(|8S>e*Zq6NuM{py|y#GJFCL6?=sn%rd(%h+0wO0w@vt
z{wd2ZNlys+OeaJ!sxGg+M`>>dI!91mn!mWOjZr)bj&7*WB)E|@+ARJNSV4#}!h5C|
z6e;q7M&3zz#sE8=d-g2qS+wCABu-O)7SDbO>`_pA|4zx4ms?w0W}p>*b|xGWKQ&zh
zXFb1C81g9ewl`kMP!b-=VRYeDIpS31MB^!)p;LtunEISZ!<<Xrf{~K8BcH5<*Zap_
zW(q3W^+vhwHIalD=!!+d%2Zao1ZESrL!VK;lU|C|Yc$T%frKFP7OgwLIH`pQSU#5M
zfa)eC;!s3wEl`-D{w~OLTczjnL<%cAoa@f$;XraFh_;v4-o2=9*P(BdsF93pw;@Po
zXxTiBZp64~!iXMvPAg*yv6_Pf)gMLw3tLTo{tqI|3nwu_J(JQ#5iJk=H0$5U$mrpM
zNSh9`(FpwRQuyVk<w)h7-PFCf{_U&>fd)3LbOtbp5IH#6{U#|9@r7T7*a?eHfKf`A
zazNn9R9@4PkC@Q-%;K7lulnm7!N5qzC@*ssBq4!p{052|Kh0V-mNa&9r0kfEsBFoa
z<_!m_9IbCFl-?5(Q<Tj+YK{FPJ-#P!7q|xFpWo-o(^WzoCgZO)@5#q08<hAnJxD?`
zwk^CZ)&1n)LZR|!$hVEX^1~K>`LHs?>#gbE@M&J@4RR{YNe<#ptQ$X!a;bdSL7J7`
zVXNk_XML7}Bk_GYs9YWmnIBOu#gdlVjX_LXGBbZY=Wyr|wig!GF5O^idRSaLn<CTF
zjTb7mwO86H<FEb~x{kh08XoSvKdnH?b!PatgS8;#o-Z3478V8r^UVdLG2XPP(l%hl
zmF)6lgZepC@UJhAQC_5V<5M*gPz0i<+ta)oQs(Z>0A!Mp_(6@YTK(l!n~-7!dKp0z
zp{8DLfs;M<2lCZauPk9O^^22U6Mj0JlhjGLHp<FyMCu4IiT{sUi74Hw-hpTXM?-ig
zbm+wxkC9tmWZ1X^Px4oGC^mNO{T((_sBJv<Ea?ezXuKKszm;5qg_F9*J|JHD{15Kb
z|8jY()Z_1*%}%Q2ImsU$J+E6nu>ZNHr)-^@wBBYp=bU9n<KHbSem1rIx?{(#_L1r)
zT~}&qx1XmPajv!Mgv+L#HPt(O9_l&q>&d3uR<-JXFXzp}=Wh?}dY(M3snOkar%STN
z93N2eu=dT^rMJ`qt8z+)HBnZmWRVpI|EUXe+COz+sx@|DDqqv-pDIkP{;AyB?B5z%
z6oyR+_?0i_3I1R9@dqQKlvZ%oUkp1Ga=b)plHpOl@v)sxgc$3nNeIhXOlP!SBt|@p
zP;I2j>8KRhk)DT?r`2=&viZKgTJwcHVh34Yvb=GZhaGUt2BDQS5u<Eig&3qB%_<Ht
zt7SDp8;|d_(ZY6<=u`0b(-N~()z!By?%8^W1fX=>I565)(p_h;%fiERXN7%;my;Ew
z_v9-%imhG)>trH!9DZzdyb++xp{yb^xVy0Bb|kOW3;0-5N5q#V{Sinc7J1Lmeu4n5
z{pAhHi)cJ}(^^WFRPy46E_SZUbv)iXz^U&R$_p?t$@gYUkN}63j<SW0x?;=>XDT16
zVE{Lk<%Bb|$AUppiv0ZbO8q_uXjl?kWrd_QmO3)?gYt?8!OY;oXWd{vg%Ge$JqdLk
zZ{yWFdAJHJN(X_a<vt-M_ZX`zg_^cd8tU|;^o<t$)}rrWfX3|ND4(SWjWevlOemzc
z^43Q7Qg-HrH?|5ozmf%^&#7~}T@FL95Bt^ER|#1_HD3_fr>oqy2I(h%#5|03R01A1
zwruo@eK6((q)~m^Wh^f&nH<ndUZI%P=u%?dQzXbDO!D#eHVLj<df|vxinn97S=4XD
z$Q@d~gJx>1(<AcZXnBwET&1Bmjv%c7=?*^KCdJ%TtIOQs-AqAQv{FozPv=0>t)3K*
zZ0DN?I~YOiMis6Mu*1T|Mm{6dE-GG0?=l!F^_h?PDftyOnwM`Z?$&x&(nZGw0w<F?
zIx*-)9ZU)lECAh1NU-t*cTDWRdEANCSxevoWM?u1_Y|Dh`+1ApWv_ew-WV!dmfz{Q
z=I+IFtsf;E_~Bdorx$~#9Ox67Tl;1d4A|fo21xK`pv!0lqqfJ$WxvqWp%J4Vm0OYp
zx_Ft)$C(T&^{wm$N(Dov$TjP-(^J{|n&W0LbwFdlfJrp!JfWq>SmXMmloZXFVp~6}
z5F+t=v5vQwTxgy3*V@r|w=-n7ah+BudlYpKG(MR(QiY+*MWfeCGHv1a)9&J}mK`hD
zuGLSsRpS}ZkwM}NkfE30M)yoQX$*>C(=&*wVo-UX{&j;~n{nF8lV2%9Rki(!;)+MY
z|F3oPOBr}2+wFOmZYZ(^wGG`xvB@~>_Hvr^aC3-KhmpKRF1%_&HhwTApFumRWN50p
ze<))I3J>J%ry&Ce2B$WRk6WnCVV}WW)8t~V`Vd-<LJ{5<J0En1<^aIj_i_5sb?%8M
z^1^kI-de#>kb3^(!gNb}q<tp32Az0{f7`Jo*H3-^yw8GmIc9T?ybk1TxW;Ddlsl-?
zZuM>|=GEPRUZji-zTHZYL4}$Mhr`h8Q<bX=Ae1i0jgq8q_xPSWPcm{?TFPY3E>Z9O
z=h{3CQV>v}a0b@f`Y#_E@U>^*c_K@V;<sx@FJnH$qVb(uhe;(w-^FR%O&facL?$_}
zi~d03S7|0SHZ~4cwj2j3kFou6+xhWt{2c_c6Vi2l>>b89edu19|KOYe9h{eF<{DTr
zc6g^|3*($s*-;-83{*<K`|dlcKsr(@_3o_FTpIS&JMF$(QeojzJ5S4eKwu$iOQ}XD
z#&U<AfznNB=(U&q35ZF<pSDzhlZzdrPfu{4&#FS^Is?2BaJ0g3=nyTf!*>2YtBvM%
z0kB!A<C416XM2Tk!_hWZ>s{ycP>^fnmDP21W2V3EvGXL1L^MJ-y|eBug=6U?13KOT
zdnCf~d7%G1tq?kp)|GVRN^TzLXi(QwVLy3zHz^yO+4y4fRPeNqRjxkI47%)PKMN8o
zsW^F{{W)_*!y}!UJCgG3Ta^aPS`pmk{LmTm^V}$w3(yFDYBA<|))S8v+<{g~c&4HO
z&m)lA@NVZafAX-Ou54PlIlGnYB=dQ`!KiY#?K_@ex}A?>_J<Q0s_0@nGwY#%W`q#u
zcE)?BS3k6v>ba)d6d%j%!|KDX_oWC?k7z!=>&E@1$xB95xl$MYGvlX(f!ND&anTQd
zk}XtQX*O<56U9rluYaDP>}dqbh*~s!US8d*Y;#J9vf@>B?#mZ7Ete8g#ATcLd38`R
zoEU!euJ}r>FRn(tvx$1=@Ki02l#7Rz_{+XS^@sUv$dp}|WAE*~9J49;h`ncsd6cob
z+S#<tx9Tu`l0y}q+N-_fv%c{ovHGd)^RSLgsFx;-J4rPR#}d#QpfMgY*z0V@59Pmk
zqXFJ*68Mq%(Dt;V3C_M!$1<#OYlaNRCmKggJb6%ZVH{%E#7m{Hut4~AQ4n2zyJ<Q5
zRu9_-Rx~H9g8{Qa2<1MMT2KACTH-o^*J;_AQO68~jltvd=bB{CUlAY=V0^yVx_*nr
zhuK@Hb$TK|ogn;!7d{@*tDO=N7yam02MqOB_=n6gsB@CG9OixBs=2*ngsxrcnREvr
zMY6JkSw%z3lVRawNxJMc3;#Z8xYKW6cQth}kYx)sx=d$ux?Y-&l=GxD(W5e{FAa1l
z&k>_6V5?-pQP9*s*2VDE1;+*C(A62y?!m}RpcQDg(g3gh;Mk}L?nd>QyAnOqs9zdo
z=Pyh(n0n(#Ao3{l;)p{e)+_u0VB7uEvD}p}u5Y&F+}FB$gjLK~{u?Zvg@WT~XoR1h
z-o*4QPXkwCB1QyzpwanqO`W?m)AcZLcipi+uiQmE)VO0}N5JYiNnbZ)%GXR&SKd!6
zin>586b$aZ{?IFJy<Rt!LPQ!6ov51^*QF9Y)^CL$;|_tsqH@bv4i#-=Xp~L#V1mky
zq%AB5HN+fLwSDZN-|`cK2!+CU#kSvq+^bS-3d19!G*thZ?;DI4&taA{3AvVftJ=Gi
z&nW(&vuy7C;^H7ykeTS_z!hJtXfH7_0lRN6!K(tS%%!WGxI}FTULBd=xo|VyxwWrt
zIr-a;JZpnA+AjyE=@hNX`*YFoP(etbV`zDc#6rLR%H=d2-7AwSo_yz!&aIhn5kS)n
z9(3Bc$1O@<BPi@dUBBp=Lv-Y!ginnWF<3C66yd5WB&0N)D3MkA)wQF~<udQQ@XrgU
zu_;c>s(*JmZPw|4uS*A*r}ik48aNLZQph~20aH%zxxK`t_CvBW`{?{bWoWuxDCD8*
zL+rxs(n6%>FC`=hD&?0SHgRtX=NFjs1hc)Rd}Y4;)v=Hv*|E~DRzyB(0r$wOZ(~%o
zhgCk<foP?=q9j@%I`>2yU)v04BZd704nGlRId@a=F=dzqMGh~w2DC;o8Upc1VF}}K
zslG;@mvKk3JkRZmvSVxA6K5fy>N4jmgApf<r%72=5NEh7f;o0*X}Tb;kJl6-yvWog
zGW2+qvQ=B}c;zUtucF@^S?NwY9kZ#EN2Tz=?|y<C-N*%Kfl-A<CL}81PJ&G(@Hb7j
z8v6Xaf#wN5lf#_DXfzkbd^o+>{FXY@FGnlna|^$=uu{f{)4XlxONaK3uGXP|kVR5B
z1d5<1Nl)r)priapB#@`B-+mxF^`h3~(@!?N%mpSC#8_HF!CiZL^pj6jlz-i1{K1z;
z`nOaVtlqge-MLk(!QE8u(>q6bF`jAnhiMce_@_sBx->~ijT02_aQsx48`i>4AYc-U
zC8b92fX(8gkjLMfApujUA4QgCUH0CFNioQ8?;0~j<poZxiCU-rcN?0Z`q#1<<#Q=R
zFxf}FhnGD;K5gcUjy7=@4iLtZ)xbQly}7fD0-8DScK7<JHtTe}G1x8wxY6DIvc7W3
zg(FNPs4d}XnPX26WKZ1n^s~I&T}!TEs<7<qZFG7t87@-Zgn=<1t#MwChVm!WR+;20
zfB(;zLVgLzM|VsbzJK#j?6!T)#oD#|K7Jni;=(LEA@dweM)xx3?k~JPJX~cG-D|VX
zUdr4rto<N+WlC^R!ocUND@HVN(du$2DUX0t5(D+ld)B<(a80w<%NgEw{+wj|rENmr
zy|=-!d3xa8cK(Amn>UarJ&lc&3OAK&J(?;rs1@4xOuW97V1^D_&B24Gf;MN`oeh}s
zi-1UK>dO2{4aW6pY3YZo1lH9qxnZNnzS~R4ZqFWHw?`&{;Py1@pTUs446Y3G@Adw^
zUQ<NULz*esn5l$vk-+$PET3m&O;WWaMXqM5Q6z*-0@M>_RlqtFCyJ!skquWywi&VD
z%4*#nFQI}+$2|0}OgIs$D$PaaMR{fYCdf&~bjo`H<4{-P0?B4V?Cz|{@@w`P>26<%
znRfMYnMMFi9W4WB^!3)nq`Y5tef)Kr+IXyh!~wW`_$V?&)4u9sK7kpk;KBBobxTM+
zqD})?%WBO^UNu)Ww;|m##q5)T{{r7&>P0bYa;@{$&LfmR<e07NzEF0knG$aF+@8O7
z^j{S<w)1^qJcOWOV9E<2EDFa#SOHQm!$>@4#Y2Q)fK|>S)0TIA*i=R|#ijk!x>?iU
zJHPN$t6Zfr#^X$W4Ut%AQ)PmdxhER*S-pm8j>M|qy2`(Vz!*>W=Cb+bN1c1_?AZP-
z=?NPKA<fUJ!=iH@RV0VrEgCreS!*8{FU6;ygreS1hB)v$Vgn)Bg|+Bta4s7&73(<B
zU3TDpW%AuG4+n{cblB{`@myExlb~vg#A=__ae2+f{)lLV{2s97{nZb~&)<Hs!zF&G
zFE{A*dRN^i$82BnKk({vWo2cX4C#CJ5OFK?(LIGAh;^h5aqRe6t&)bns{6>Ru^>cS
zwC)Kdi@0Rb@J+YA-ZbORd98@_Np$;m3=FeLy_WdHy<3-=oWZUq^D#qY)n>1^+>#WF
zU@mAf3@-bdy7TXuD^F$v7fXH2n5ym05(I?0D~(EM*KdFQ1sfk$s!!G_MNfvaIF-Jf
zfLcVHY3b_h4X!({F7B4RZ%!9%qDu4EdDr%jH>4Q5i)FjaWM4O&a`NBgLY-SS(}5T&
z7!WnBgLeMdNM9H}QizgVSaP2G0Z$kxO!guaQa8$sJ@^*bJ7)=Q10S7bO;*y2YyaZ<
z)jNRiP$^O_YJsY7aA#3ENMppO1_x4tsTIe6+IfO;7($E#S26<<CD96k@Hl*Yy_tno
z@b&B0H|2;oAT?z?LiCr+E^Fa>FN%Ki-k)tLyER=>LH=mN5$SVaaKhaP@>a)eDdb?a
zrO4&)?~+=~$USsu<f*We7Izcs9;N;Ly~ZG36-?Fg@KwyWZ~-qnW`8f*57jtzf;P1@
z9T7E?(w^u7AZ}!~ddqR|5wWYDo<eag)^u0{*9BBnls<R1+2~%ri@Sk3`H$TgC3zJQ
z(?;Q@T3Y(c*sBPVOktS7Kkczbzbxs4m9|A~j4(wJV9ONd4W(Mj0@LUm&jL)a&5jiV
zKu!Ble1hDp#(pJ4(27<)(E<VY*nj1EtL8roF>!o-<x=`2*@g?~pB}6_+^^X?D2a0*
z<dD&Db9i%IhA=<^4`;m#*#L}eK3c>0Hh?#btCX^&vJOxq17W0)%EX%M=+XqyB0md0
zK>q$YnYUtDXzV+Y5Un9a<zkOr{`z(5VLCt^qOML6CML>mW$+%~0UKtJGQG<7({;bM
z<mULm*}RcfG%4<LduKs%Rx)FfnsTP_v*hhk(feF4n5prNM!!+&IzCVoV4$o1ZZnnx
zMFdXiKv>5T5eIi!7TKD<SU&3=(JkwbZO2jxhn~P6qf=kH%OI3EFxfGQMoghKOH51^
zmK))IpAdSL@lG<>`SB>~r&!&LJ%v4e;reMNDVMO>g=Hhf{vAn+ozZ{6Mg#q?-;w;?
z%(?Ingzhanmx#DPO6V}N$nYRb2T@K|S{_AABa~LoRHlpIgRh3JV`Iv|ASIlG7S~^&
zsycg3nO)fJ!n_|F6Qy4o=$)P^T`^!RqG}O_LrHF1GGlbWtgo9k;ZlqQOp~KW-LgP%
zKWe>#(dApt7(etpt?$G(!lg$9#Dw%)%`EiJ$2)CzOuVQygY}`bo%*E9_<_aBurj?}
zqqn?HWRG#TlKTsrylU>;xstdTt2?FU-Pr%o5Ngd;1m8}<<E#8}J^ZwN`}UdaeRbk)
z`z_BwDbmx^H<eod>M~nrk{|;*GeLq_gI;M3i5hJl`kIa6v3kb;*0~3NrnlifdD<Tg
zASrsEVUOFdDKNR%Vb#4rI!KvWQn{*n4-?=(<US-aGSiJ`z?G9is(-gO>xrVSroYR*
za~0mVof8uSh$YBfIPaKD3wz(|oN;8;KI-y43ge1KNOIWkOGeE1H7lHLw)}|2@9huF
zecGZK?hH>Ps{=NKp$G>eS&7FaAA-kk!aly=tD>e&N)+bH*LDav5*Hl^gDlLEHZ|f&
zm=PjKC~-P2uF-@)VQbHhe<XB2&-h7=4VeDW(@-Iq0lz2{LY(Mx33pXuUNn(T5gPc7
zIhK1-OE?wV+Grco14@0bpON0%<Ld>NXPBWWV}ujj)H|p8SXhU_Bd~|x=E6Xya>mYS
z(77%(eRvp__FLqx%iDY>NZG;joc(?sj6qk{9jMu}pHy?1|MDGMp7))NMSvl~aFlX7
z*6bM6qqp{@CzIbIrQ|CH9A~|MXDQK$1N$61Yzn2GL_~*Cj*???mwrOZ=sjlL55Fxk
zX5+>>rcky*T~2tQM0+BCAb2;<R+7M@mueF|{_yTzZE)`N5BHYD4orryq%hucL`p`U
z+dJ?6!ReXZSt&~H`QclsCkMMcwphN8WKj66kiudhTN07Xw*O#GMoia$L}+kvvVeH0
z(e-pLex{r7E=p;EtC6=j#YKl=>I62{n!z?>>an-fM}=l7z1P|al}o5Q#H@O1!f}8d
zZ=%x!lu1bF-#r?48nr$%U`M~KqKq+bkDtbe6=Ko6Dl)EU6&+dHyy@1FMe0|z2`)2H
zgPPG>QbxmKWv{&9M0OA#DM)Sb>BX+LNw4?pUp(JeMxnqH9W(xQ?Xnfec1`S0)!i6I
z<e~kaOPSB|p?m$ny^rf(bxoA$cyupq-8Q-T>jYBx(EZ~;T_G1xlj+?0_Lh9VaUI@0
zy>u3@=9o>-w+nZKx4>*&w_f9Vr@rEVo&WNy&hva#4R)0%li7b<*)0t_kGVaUGH3wA
z_>f*^d(yYpeZU-ivM(mbI&$!qS`X9K)-K-&k|=T`B3vVrD}~?68uEA!S-V%+vThP7
zVKt9_`|I5i$vP^p<M=-3KSl_;_QjqA_3+7>kq|PvS35LCCumwkr8AsB>q_=eVgQ&3
z911Jf54S}u=Cz{}Z&RfARmL=iy5}7i;4W~VfuBoqqit$mb<G%mI#G*^nJJE`0FDxB
zh^(3^yPI?_eq%}04DG8w!1akSQDXgtf&sLOI+OU*%#r~{Hm)CbNUspQTfyDJ%j%u`
zciAgyo1%^LKA~nc8E$;k3_UwGvbbN$4jI%&1nQ5P(bTv}qhTiacrfC|Uk=rA1NUZr
ze)r_{k&2|e;d%O8y7BBWh4DZ>ro#Dx<EiZ1Vi()4UJrvsRF5zzsU+WBJ=~yb#6wAU
zCJh%};^5~S*#yC#i+Q3%7z2%@L4>NDGbLdMx~^<LPx3v(vj``0mG{xEQL7Q~35K>a
zXr!?7&7LJ{|4lho1YIPks>>hd5mvM=d~&}Ij~%b%gfL2Y66N`@C$BpcHpz%M<L3&>
z5gGIN$&;rItm#(6mq!c$HY~|wf$_Tnz8+o*#9~Ps1<i#iR(}rb+<FKit5T4mo8wjV
z8W;i0#@;RI1w$bZKV4s0Q}ZT2-{;vVUe<He>ceUR!wc0|L~dX^lgj(dFQOwu3?@=-
zMHf@FBT~osZKqB1?DU$f9e9d&=Po@Iuf{pq7q5NR^04a-+}+ij_x61O4C<h9glb>=
zd!#T1pCvaIRx_lYb)T_Mv_XKvr8rJq+HEHw3pmKasD_g1Z^~W7g^}wBXNW9F|9t|v
zX?lV;KKE60-J4N~PX-(qCt;xACF!dg0KbJA2=~nx0!jI+y~8LV#7uwt_uBNt?1}gU
zosI7oO2z<#E}Au-X=d5aEFI^oi)9o#%pZR!`-%H)%}6}cTv6CD@X=s8fY|v9*;oc)
z7o=OLV2@^$F_BiEO)s}r{!xI08Kdf+;y^Nx3Cv)<rhD~l*-RtG4b+_gMI&Z5F9yFp
zx|CcIPcCtB_Wn}{UkN@kyPHd2%y6uu#i@@CHD`Y39n1XRw7L@ccTCv*m~kDmV-IYJ
zbSmpVhxkLvj(?Q?WAP@hY7(>)V<3z@A~VSt-zPS>KL{9mCH;@;`%D0n1{LY}r55Ty
z60KBr`s>i_`#LlAOK*N93Q#-lv~K>huv*Hn70QwjAqyI6rLT8h#l5CVg%?;>v(s*A
zXX!C~k>~2fy3Zzo{bbUt4k0OrY_f9a(tbxMtw~i6&UqGkU_s<P(iYR#t?XBfo3s<d
zl8k^k|KTUOD8`?vv)^po%6;(uIB}`liL4KH;KTavbV`y`hKL?4G81cRW8@}?IAN)X
zoX=rDzq4!%(Y2|jV&L)oW&?xuQlYnBM*0aN1T*<0s-x3j4m{c!RuOxwk9ETThYgx_
zJe1gs5Qn}nG0@V?0*;vy$zKU~5oj<?9KAes!tvB6yLt_~UP_lAg$Y`?K&}P;(qVLS
z<q@$>(uGJ!Kl(+;TM_7a^mZ=UC&0NHpYO9p8Ka?;LL|e}Iz5Mf_~C&5=Oe<qq&{qi
z&vp6xLh_l@#r7K67uh}E%Trs;@Z}qj#i;4-_zWi%Yq^l7jkP=O&;*fQ;$AV9r-Da`
z;HgL_N(}R+DMtHMdFBDOJ;8RBqq~8Wu*7N4;+-R?sWq%bJJ5xR>91?BR#W9R@xH?O
zqEI=*TUHzL4RwmyQk3QH&q>!3Aw{%UU*W7$J27V)s!<d$st#<Z>PzWP=wuhQG!tTP
za_v$*CnLeZ2veI<6KlJu_8C#OrG!u7nIU+hxnv|HVt755(FQD7xyi~`w5miWN-{QX
zSlA0vmd$Obuc(}~L!^hQpG`}pqri!Fd<mJ&u{8u0Qq!erW||-_BCQPzVW~Y}jObp8
zc%ux$23*>|s{&?|z{z3(#B~cdf<`ataT8uJeTSJt&K^HS5Y0wozyIFXnl7JFL?3k7
zES|7HtgE7v%1|doP;-KK>5Y{x8g{mHp1Q$E^*%%NOV^e~eDDk^yRR<&*&a-kn{hzK
z?Zb<z<Zt%g7V?<LRdLD6ema=9($p;!PV)N$PglUimnLEA);i1Xc5q`}rx<c(3Jav5
z6keilqD$_J#)2-}QBYe^73Px)MaU_;IFsr<$;2rTay!~mg)A$LN*p|)4}bUxSwwR*
z8VA)^Geb}p2`TAB1RCADX2C^Y&$NPl(UXin`m>F#txt%WodniGa`^jV%ChWO$>+9h
z+cq*ft+wiuvVVaBq|mp8r6u11jkCvh%YPhqJ^JsMDl&2BNBR}&qefZK6dNpE(sH4)
zk!X$;9Q$5Lg<rKl#)?hU=S3iKiRgnmzd5?Xx7vep*g^r1t6%=y{<2eni7c}mzRRvv
z>+})hB2*KRNk|CNUj+9xX}FH<{m!!a8mhAr>8gI++O4g!MDO|RHx*aK=&jyCpO!sG
z7(+5w7$s#lziR&uwl4(~bDw1AYdPSU{6}1-YJGVFmP4x4IHz*DSEP&jLxmo#eE?`H
z5y1@pd~~Gko`mW`&AN|%iRovI4!!DM1t&ce)5i#>cl`Po{>iH*=k5IUs5!Ck&Too1
zD)L-Ztw@iA59)k>$l2d*Jop-6W^*zJyFbTrNzNE-&$RS7bl<}`m=qTi^zy29CM}lY
z8eoy%nN1Nw{*FLmjiw12I1QF3dM_ds0VlX)@b&POkAn`ye=qEO8i~W!KO8f4Zpe?j
zuS8TmedHd}Mmx@sm=JUN!MVxwgwF`6g>BkoKog-vQ|S$9QihjKO*uu>GiG={)GN}G
zW?vz3!0mQI<6AnsB#b1le>K!eaCtZffu)vTRvfJvMe<?<9`e>+jhvj&_oiR7Q~8b+
zxFBj~GbJ2FN$fNoH0JR;_Nz%&1tPI`*hFwxbIg|;e8uWkeOoepc7X_r3m=t5s6JAW
zQkW%ekVYm%V6U4v?`DSlkAnAtlavGW9rpjtYF+X4rmlV|svf1KbzhseP5R}^k*d58
ze$;a1;qg8J4aWVlada=+%<4(D`mRF?0!r47zJJ4-crFd*ytH1pk)+9k6S8^vyC;*R
zor)+T+{uyCIJkFR=iBYKJXo=8S+BXffEaoH0zr|>m~ouO4qBB9k|lK!6u%{^8xztl
z<>F<J26us#SvjBm;};E?^Xu)+5_T&LbI3nD*Ih=3jZ9UHpOma|b$u>9poJfYHyD8O
zMs^C@eTF_TdOZ0Vk+c>-aKazfZ<8<4*zDD7j0tFuczSWC;vPlKPMj~{YeifQ^)f2n
zKn=^IYcBSgc(~bh+o4f~#9!qu5G;-sZ%lX;TU=S0YcT8H;8qEbE@}yN!G*{Oin@sQ
z0ycHE-Za72mUgXP74wqEp51d<tGeouN0g}V;}@hKNcx}!V<z2wA}dL7g}scul|>!X
zXzG?vGfZfs-C>WSCpnr0wHFEy6DIsNqDg|C|A+Mgv#BKg5_oBGH*Covp1MbB;J3;(
zQp6mf>(F?=K*3asrPu{~`~LGc>=rZ36>eOL3*YSDToCMMkH#7Kqcl`-e4;8<%D=gw
zHG{{Oim6Jcs;EyNp>%dh3c-Cz+w{|?Pm_DYgO|nw$&z7{Z2qIh_JRGdqh^UjY)fBc
zb9Iu}z_tPYygc#koQ{$lQS=-|o9FbtuBBTU&w5gfCMptuSaTx(=wVRte7)|{J1R<h
zp5S^_$qpx1e9Vy%*1&YLxbFvM%fNZn@ctC{xpJbjMB#(WBTWAL*wLfX8B8n+8fJ$z
zrYmB%Q1>|hMVPNN(Y6Gd{dnX<+oaIcvxc&xNNHbQ*`QFLiU6ok`M}Vn@&aD);pLw?
zGli`TcnQ`mJO#Q#ueJ87k&eu+R!+a7c@!kT!Dzz(!V&CrZ)$plRET%)`VD^>Bv}&Z
zsaLlV6Cpa}?|*V~QVZGmJkTs5Bh}W{R&L>6c$g(4`U@yLki-!ViJyyM2OwzNj<ggK
zRd`)l5!Q|f&w>iH6ePflZCHKSe{*pW6bQ`=c6exNlJQ|2yyYwfIA_k6&F`FHW?^Jf
z8*f&IDM_2+t+VK+g1q!b-REr44V~V54f_Wj0Jktb2pYUw3OM3U5XpW*t6Ldv=+2cf
z%)}KP1L=$9HFHPz+Mn1J+7x!A*LwGXfjfuKy!8CDv2sC!-akQG>^>%qTrZfkPI}`-
zs#{m26%cMDuagfah);(fB`Vmq53PqqI2u7qIYF<y)LE&*gc%QIr&Sl(G-wzhEp%A>
zdg(2b*ARWy7iL8VO4k}#`uXSXl>iaqzm-k(xD0{Dwd3D?O8`>GXvHV6syMhaiofH|
zrAF?LiiBtrS*?GdD=3MGYT$1r(3Bukqt<BK9w{GiPGX>GQWKpeX&#v-8WAycPEL<`
z9JU8qzXQCMcoba4h`@1~fJ}*y(ZvYBUJGlT^#<NTs&I;ANAY48Xr4}ZGIff1^th&W
zUvc~-Cg8B;;nCexXsVeZB?LgLXb24j@Hx^2HHM~1fkBj}2^Fg;DxG8~^+f5gVK1DT
zyjR2<L`U|+uJ+y>qydDR8blK9^~(+-o;L(%zwWQQ-^6ZHx*J7|44>G4ny{yuwF#5j
z+up9jB#`ap5e;rE0gNbSioHyCA9yLKO`A3;y(<3r?os+uge1n6T%QZL>TBEk(i)@O
zGUC*g_<NCdZ?4iU2y5dr<^`oj9SAuzp-MktRv_u%$Q2b0;`~We+DrDpREI21wKV-p
z@G8_4>E*RIkA;yZ=@d6Da3T$|hxf;3SBdGQv||7Bx1SV>9(P0+z!Lh<YS$X?@ilPn
zOdB?5$C@o%*sGzW6F>%Vov-a}gS^LKa|g@z>M?f1IY~-y_dU39-MxYID4*o$cF2uA
zSC`@v`NKU2m~78?>^g>P7E%I1i-cFNqgUA4O6nmwpih(+mqySil~eMMne?L{-me|H
z<xck%D|xg6jq3E!52?rM+R=6?S)g<<2+u=ON2TWd-%saC2rUA)Vv?X999AO}2*9Qh
zm<)4vCtt}T7AoV>%vUyXSHAp8f@lJD^-nI!)8!ez*p-X3J=<0B%3FV@OX77K&Ddr-
zYkrtp7alPC_OJd8nN&uJNzQ$EdMES<n3@B=TKco3iYV>Tn3JLF-&7HEONVqAwz7~I
z_vmZjbZM+0N}|1Si);UMZ?~Sh_GctP1Tr@RvITPx?iJ;v<7>x}JA#z-xuX9F7cBXt
zRBZU{3?Ws~bSbq3z)2B&8BxQ$WZCp=9VtscG-wbxj>FFeu~9|b2f7LXSD%Ju6Co@S
zat!Dlu-Il~TJ}XPrmdLctED17V`yqMDW?OeJo&h?Mvg^7_<jy~k||AP5^#;IFnDo<
zf}?Z_QDaR<VP;)oA`BO?7m~D)xd|tQ53*Su5wvIFv6AeIwtK%{{X7&PmcXnCw3v31
z%vRC&$b2qKzoKt2aPXD%rttzG(D{Vs@pn=smy)x7GEVIGhCtEH2mjLebVx09KCi>4
zW?X!{cINX@;g`n0T$WxDT@qitxl`zjjB@8kC6f*FkN;8URik=P8fjY#rkdWlscX=Z
z!kVm6TU)yC;cw&N^47+k|7EE1vGf1_6LRqXcRC0bI$Oz|cd~#*q17b<+DSq?;+xV#
z%Ju`#b$F6{vBmK+mkIzaURz?HP%|aGs?NmV1AFD&#uo3C4IA?N|DajHvqzZ-2C(~_
zMY&7i>C)Kq5IO;SdrDehWpg_##c~T9XG;a`bS3B$e<G>q;#=F}wFP%F)NgEPO7{e6
zW19Fx_5<fT3mqqsO3!khFPBr;QCX4-YOaN<2SzZ_=lF3gVi&d{P~wmtUYX8z%GZ7A
zX!3{1Db2yyx1Ecpd5iQblmrL5Xq*uZm+Nih$cHW$NeHRfljfU5Gg+h#Dn|w-n4)vv
z%LkS>wl*4jQTi5Vzj@q=r7u3wq>fgzwM#*;UYPKD4C@-3l}t}#cr8)-aX#84L5*!+
z0QDhLCRJHR|I6zR5kK0Ks!$Ievau&{BZz`fBuErvEQN6IS^Y&=u(_`-lLmx4v2OJK
zhNT+-DMW$`lbF@m)Ku8FacO#7|MYOID7jKooE69T;5}1L3$8_pCo)}DI;dW$YoeHy
zO1db;U$`bTbDnhL4T9MqI1qD3$tW~7P_j`Jg9{|yCbk6~)rbiM2;gj=#lL6FbL0aR
zg~J$X^P8Dd7q0kK!kodF^I$(~moVysVyfLhhD6!jE4{hGpv&`I)auNHJY-m<l7s~9
zhgMy0edVqK;%n{tVX}w@5Um`Llx&)sNtSIB-G>*?*|!-Ow<di&fu6+DM1Q!B$kc9t
zXrkHWj1Yb}fjAVG4C}%7%>!~h6!z^ZMg^^lOKf65Uy0$i*M6I74{OakZ;0a-87OC}
zN>CcposA5=BHr6X@#%dq&V-Q;px5NC`Sr*0KUGmvrn)7hlWerpMBGR^%V2;*-_9%S
zzr3tzd27Ds)qnk-J9`6LBZmB`3ZfDa4#I;)eM6fjtg)y0Me+}X&EwZ)zXidT@}0;7
z4fI<mgA@*Tf0exCLggkZO3Z4BS=(G;?6KD4D@Cno<3lj(u=@wP82i<+>xXST1}Q+g
zRpD)>onM^fbZ?;F;jwcmu)?wI_(GT<zci{}hTqkB@J;jgl;MV}P#-3~d-k*P)DJiJ
zY|MP18~tC_h4jB;0hM)K*_4X^=@zZO!i$LaD*IF8I&<a>Mp7}$lIXfuyElKx=Y{s*
zfEnI8uQdb0f}CYtFeHk{Sp%EgH2O&|pqiop^#<GQ4OV{g0D?})IaAw52}8YCJL%Wh
zUZHT;As&FdfSYZpYyvWEO<kp5|LsYOMI#~pFYg(h_ui%f!3y#Fj9VAAgb5?87?6%H
zAKORyvCUF0rjxD*xK|fAGw{mv8fFu4h?apYW&3F8R9T5ujA4M^oMkIF0ROGo)J8(5
z@_+4DYAP##{U4Zl<!k<@*YiJ7%Ufa3z-;4-$)QS~rttx_Eh=M<j^7bD-2Fh)!WQo>
z3}3P48cD^E`@VRPH9B#U`MIdQ93DfrJe@NSu7><INcFeb9TKNDDQ{k(+3y4N4%J1|
zS|1&8Z=YS!!}FbApPj`5ntG=kJmsxglNdN`Yu~Z*!9)1qi6dx=8T&ryW~<S?8!DQ`
z_gi#nom9ZXANoGDe{Vj;dy=nJ)@_CE-rUokF8hdmhD+@8@oL*Ko6Bgg@jTRd&z+W&
zN)P>3GRLs)c3tafDv--H)R%ocr|jd?_&N8qLNR)b>o4MV<j1pFV<^zzSn@E|^6dp(
zPwkBbJqzn>)*Z^U>lL{7*~e-9w%$zK=o9wc+iuT2jhBtF2s|^8H@ZwywtFfR`f82s
zi=KTt30IM2Xx~U3R|M_)!f1UwN$HCeig*3l-SSg*P)Sny&;2nJ(;JFMDDOwHX4$T!
z3EPBJ%8DF{iT$z^C81wJr~jX=QssbWv2_F7@OTEPS+gzbuQb*YOU-7c{a)p|Kg90a
zl#8L^8uvfCKY#jP%DeWrq|+>3)7aMNI&He8X3|)j)}UFj>L|f%lUb%Y-llvKEzMgc
zc|}cunQ=Ew6Sp<7B=yM~6Fq5S;s}F`qscT3nVFHYh{}wJglMP;2<%a3cK?X|37#+T
z<vq90Ip_Vp=Nwkby?(i?;1Cm;r|lS2*vd7ZI6MEuyvbmUwi|3@%R7wb6u9<Wo&mS}
zk%=s>D`Fyd_iM6Mua#LpC$xRTnC`*Qnr`%rZ>b-c!eI?Y%%Xw#BxOfL1XR&2$@*WR
zg1|*XHQFtCuGPkZY}tvI+46jhznB$b>lYreaKWHdhlSW4w6mJ&QYY%St;r61T+C{f
z;9)f7F={-{gDt_wc{}!9@l=xF5bCR}omn_OP*Pc0NlWcau7UxXX_(r2*Wx1S`gFKg
zZ9hj!<o}v}LxSH9Ep(lo-=Wn6syx@J{Mnx4^#j;@r92m522KP^@}fh<owM`Cg1-gs
zEyq(rQ;j#-%`iam*s<P=hZH2TPjxIu(wBrP?mj<@{{sn>E@wQhL;RG)Q+N5Mi2Lvz
zC5lXkp7GhH6o=qJl*F+?UMoxhYDU|oS3D)Y6se{{uH*cpG|}*1(mqhr2NlBSlfZ7}
zf)BK9`B|<hDuOc@A)>6?@x!VwgGX4ULziF{o#0odm`ldg#=#mcwL>5}_h<_*xeBHV
z4WNQx!FJY#Uh7S;mTlGvZNrE=71#s9j1S6NHY}rB;MP<@ytX5;XW>a|+5wM#4Z3Mi
z!Rdmo93YUh$Zb;Vxoi#&I(g6%1J;`o+HRoxIsZJu?O`xtJ!yU+wzwZ_x)28r9FS-y
zGku;am6xpwd+r48g+IK;r7T?A2_M~(>ninMtd{z&TRM2WJ_K1QXkHE&Iay8kJHooK
zIse&tk0OwgT^V0Z$Pi`i1ZGcabU})0CX&N+gK3lJ;sQC3W1^$kxaml$UyVG38V}sK
zbDG{NRr8GY<goo|<)=4C^=E)s?*_(pMvdMhEEU(e#`;uaq8vNV7+^CQU#QOpEymN0
z3x{!P$_n2TLD(7{8fp)M6pgRCT#MhRwK#KpWM6vc+tc`{eo;QAjFlqGL6bVKuA$;=
z-0gVX<JZK9hyj)=XcLVP$;<Moc3Ol=>zjO;w^Ny#Fhg!?R>Hf3G@%pauyZWhi4Tfl
zB#|}tkS$m;!b;~8`({}+`XeG@jC*AvkxoFAVuyYp?-??YZP_tqld7>@p&8`l&v&$(
zXuRcA;Z_y67bLlzN%y;-7dlHeS}B~a`>R?`{gU5!^)IUjZoV{chJKO7bvcZ;!o>Bd
zAH=mNW!U;=B^cg?PxDe>4dba(1P)&<G0Yj}KV|<6+bv+vAZp2rW&MO`iJN*WzzTPY
z2*;P+s0dy}dbKp|&)$eKe(-??qB6a+7bGv6dsCWt=x%QgdS(PTnL{M10=7RADIqeJ
z#0o(3SSg%CUJ9qLii$)cQIeR&QIFXtr^)IC1%oTv!Tng3(ZXv=uIcL8Rqd3M;4WQs
zTXRgL2Bl<?FFQERrYJH;h7jfxk<>JAN4&cu_cajSg!x!y4Vn^MK|OgtZNJXuOl5aM
z<m(D)a@F2NgE45Tx`91Y{;a|BZ5UCn%O}}P(0BP(q&{OJ0g<5Z1nt@)2sH;yF_I9#
zri}&NJY}mq_l(nI4N_3otONtW4cCRMvHco%J2K}X3GI|!V$YYgKK!co^ydv0g-yxq
z7p9L(_A9vg^H_z(iK|wYTPAy%7wUTbS>hA`D39;W-~6s4yI}^w8+->Y_g^qTRWYO3
zW6?(w?oDWm+&<BfvI9T~I?bmOwYIic19=~cl;^N(C@6RpO(BJR3Z3e{UJMrzJ!z7+
z8v!K-SSdill89%@I$RT;Xw<iX-7j2|s6xw%@Ev5FNJ3nn);{IoP&%rby(;zu=o0$g
z5heiEan74-=I;W<6Iw-q^5AyAfr^UU$%{SblJCpgwC`BR=L=@K?xf4M8g8JMq!1op
zBPgo+E{m0Bj!-a)va@239l?DE8S@#+<nG)W$aadrq@mtznn3jmvVkiX58V(ZXd1U*
zD{6GbdEM{0HtXRkuo}J>G??kK30%PnDE{d@${}mJK3cupCCX->Xiu)9vEaxRJi+Yn
zxHUae3t02$3$Wc$;eyySNHN)djy;S;wCAzPu=}d7e~VGI!fZFo%LwRJ4T=%ldKP^}
z8!26jS;qW-(kv(V6Cxt!^m+%s5Oli@4=KpW%>|9MlWRIT-?12sX1wl9K>IJbrVIAe
zj!+NN+vayDsz&D+A4zCTijIj<vv|!$Q*eWPzu*w83Vf4T<q0TwCYs*=atVR^hK35#
z%o1bz#{sMst`WlsQ;)(&k~*VEK4!#%M19v{g=smVkyPApW#TDCgM;#_n7-8~W;4AF
zS;AmUq<ZJuZFB)8uWHhzN8Yiu>qrq-^yX&nQ%g6A;41@3wpqCBlFdZwB`tmH5p90f
z!FZIz3ZiB^OpJ`D7J-}6=$6lwxQK{k5^Xh(`~Jf@*B?#Aux0D^9y;Trnf6TG6twbt
zj2lF?idA(C2K_TxX233sKEIGm`um{wlG+vumV`C?U&y{xzHJNX>+w|JkZ$savC9vZ
zU$$9d%N)!2XIn%u?6UFQ*f_#UzWJqD+kC3y-{k@0=pFY)Ee(T-$9lus=cW6Lo%fcX
z1UIW((Bp?!c=>Q>{|JlQ`MGCu)g;co#&+q$jRp8bGr%8G5ZgBVT^`l;F&VVKD27LR
z3Y}ubYu;C@c2JqeC0gkta_zRb8DRw5D#zP#^!7fOOOd_745%XKMSl+{(>i<w5S?K8
zi8jAcO{!hp$yoO-RJwtC0>s4`7go`_Z!YI1a1$a8iJALHc-RQ$vJ<>82o5QjfW}(B
ztw3`}b|rn504`IJIek<cUT(@kACIJ(o6|@x>v&P_t<f#@42Em5b5+v~b~8tiRUVFU
z!S&MKGrj_NkUlZHzTla}NvP?g`pm5#S%?+Pv7#I=|1$km@#4%f*^>e@C`MHT@z4|V
zPu5zXzx8Y{KqOF}^%be=Arl$rQ$4y2!N7{n7Ig1oFpAOrvV6=6dj!93g-&*PCU|`~
z#K^mzSAqZmN`?Q64vtdeR~(&(T`!4O22oWO&VSk39|8u+EJna|Z{T@4T5~X=pWNv_
zzXf_}A}X)jm+>XuVMz$yXIj*Af6lXqjADRVxA2B4jkfQvc2?jt`$#-qF6G(9ckW}P
zC+9H2;Avk0v-$l%oCtDd_6v-K{3`!l5@k>xZ8n97>s&#<IK-RB>uFC5^3=M+ej&Yp
z4=^6h?Nvib312oRls8#YlxzxEp~2X78A>i87@_%EhwiIK3TCJXc69GjfHczJQhaoE
zUt_rtS6FA>lNxMX7G9fqaQk^;?Fw^N1DqY=w)i;HWCq&T#B<}S)zp`rGcH2aVIr~J
zSnE)-^Eb$vr~mM(Uk@N5v0!S!hGlc!492xL{OkgC3tB4OR9S8&q}E1ZW57Tpcx?V;
zro(s&t>yWU^q#ov_pma5SHFgqzE8XSD7BK$L>lI~02}pE7+Sqz;$s`64?0XZ;;_PG
z(_nbtRQX^ne|TX-X7u@*cf4J5X;YiKkBIK^SAMbX|1a<QJ(;|3-eB+1J3({ct#0z3
N^gDg5`RMtt{{v`LkaPe5

literal 0
HcmV?d00001

diff --git a/modules/cnf-about-ptp-and-clock-synchronization.adoc b/modules/cnf-about-ptp-and-clock-synchronization.adoc
index 30831ef73c..10e0561a2c 100644
--- a/modules/cnf-about-ptp-and-clock-synchronization.adoc
+++ b/modules/cnf-about-ptp-and-clock-synchronization.adoc
@@ -1,14 +1,21 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/about-ptp.adoc
 
 :_mod-docs-content-type: CONCEPT
 [id="cnf-about-ptp-and-clock-synchronization_{context}"]
 = About PTP and clock synchronization error events
 
-Loss of PTP synchronization is a critical error for a RAN network. If synchronization is lost on a node, the radio might be shut down and the network Over the Air (OTA) traffic might be shifted to another node in the wireless network. Fast event notifications mitigate against workload errors by allowing cluster nodes to communicate PTP clock sync status to the vRAN application running in the DU.
+Cloud native applications such as virtual RAN (vRAN) require access to notifications about hardware timing events that are critical to the functioning of the overall network.
+PTP clock synchronization errors can negatively affect the performance and reliability of your low-latency application, for example, a vRAN application running in a distributed unit (DU).
 
-Event notifications are available to vRAN applications running on the same DU node. A publish/subscribe REST API passes events notifications to the messaging bus. Publish/subscribe messaging, or pub-sub messaging, is an asynchronous service-to-service communication architecture where any message published to a topic is immediately received by all of the subscribers to the topic.
+Loss of PTP synchronization is a critical error for a RAN network.
+If synchronization is lost on a node, the radio might be shut down and the network Over the Air (OTA) traffic might be shifted to another node in the wireless network.
+Fast event notifications mitigate against workload errors by allowing cluster nodes to communicate PTP clock sync status to the vRAN application running in the DU.
+
+Event notifications are available to vRAN applications running on the same DU node.
+A publish/subscribe REST API passes events notifications to the messaging bus.
+Publish/subscribe messaging, or pub-sub messaging, is an asynchronous service-to-service communication architecture where any message published to a topic is immediately received by all of the subscribers to the topic.
 
 The PTP Operator generates fast event notifications for every PTP-capable network interface. You can access the events by using a `cloud-event-proxy` sidecar container over an HTTP message bus.
 
diff --git a/modules/cnf-about-ptp-events-consumer-sidecar-and-http-transport.adoc b/modules/cnf-about-ptp-events-consumer-sidecar-and-http-transport.adoc
new file mode 100644
index 0000000000..58aab1f390
--- /dev/null
+++ b/modules/cnf-about-ptp-events-consumer-sidecar-and-http-transport.adoc
@@ -0,0 +1,37 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="cnf-about-ptp-events-consumer-sidecar-and-http-transport_{context}"]
+= Retrieving PTP events with the PTP events REST API v1
+
+Applications run the `cloud-event-proxy` container in a sidecar pattern to subscribe to PTP events.
+The `cloud-event-proxy` sidecar container can access the same resources as the primary application container without using any of the resources of the primary application and with no significant latency.
+
+.Overview of PTP fast events with consumer sidecar and HTTP message transport
+image::319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.13.png[Overview of PTP fast events with consumer sidecar and HTTP message transport]
+
+image:darkcircle-1.png[20,20] Event is generated on the cluster host::
+`linuxptp-daemon` in the PTP Operator-managed pod runs as a Kubernetes `DaemonSet` and manages the various `linuxptp` processes (`ptp4l`, `phc2sys`, and optionally for grandmaster clocks, `ts2phc`).
+The `linuxptp-daemon` passes the event to the UNIX domain socket.
+
+image:darkcircle-2.png[20,20] Event is passed to the cloud-event-proxy sidecar::
+The PTP plugin reads the event from the UNIX domain socket and passes it to the `cloud-event-proxy` sidecar in the PTP Operator-managed pod.
+`cloud-event-proxy` delivers the event from the Kubernetes infrastructure to Cloud-Native Network Functions (CNFs) with low latency.
+
+image:darkcircle-3.png[20,20] Event is persisted::
+The `cloud-event-proxy` sidecar in the PTP Operator-managed pod processes the event and publishes the cloud-native event by using a REST API.
+
+image:darkcircle-4.png[20,20] Message is transported::
+The message transporter transports the event to the `cloud-event-proxy` sidecar in the application pod over HTTP.
+
+image:darkcircle-5.png[20,20] Event is available from the REST API::
+The `cloud-event-proxy` sidecar in the Application pod processes the event and makes it available by using the REST API.
+
+image:darkcircle-6.png[20,20] Consumer application requests a subscription and receives the subscribed event::
+The consumer application sends an API request to the `cloud-event-proxy` sidecar in the application pod to create a PTP events subscription.
+The `cloud-event-proxy` sidecar creates an HTTP messaging listener protocol for the resource specified in the subscription.
+
+The `cloud-event-proxy` sidecar in the application pod receives the event from the PTP Operator-managed pod, unwraps the cloud events object to retrieve the data, and posts the event to the consumer application.
+The consumer application listens to the address specified in the resource qualifier and receives and processes the PTP event.
diff --git a/modules/cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api.adoc b/modules/cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api.adoc
new file mode 100644
index 0000000000..aba7196760
--- /dev/null
+++ b/modules/cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api.adoc
@@ -0,0 +1,28 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api_{context}"]
+= Retrieving PTP events with the PTP events REST API v2
+
+Applications subscribe to PTP events by using an O-RAN v3 compatible REST API in the producer-side cloud event proxy sidecar.
+The `cloud-event-proxy` sidecar container can access the same resources as the primary application container without using any of the resources of the primary application and with no significant latency.
+
+.Overview of consuming PTP fast events from the PTP event producer REST API v2
+image::319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.17.png[Overview of consuming PTP fast events from the PTP event producer REST API]
+
+image:darkcircle-1.png[20,20] Event is generated on the cluster host::
+The `linuxptp-daemon` process in the PTP Operator-managed pod runs as a Kubernetes `DaemonSet` and manages the various `linuxptp` processes (`ptp4l`, `phc2sys`, and optionally for grandmaster clocks, `ts2phc`).
+The `linuxptp-daemon` passes the event to the UNIX domain socket.
+
+image:darkcircle-2.png[20,20] Event is passed to the cloud-event-proxy sidecar::
+The PTP plugin reads the event from the UNIX domain socket and passes it to the `cloud-event-proxy` sidecar in the PTP Operator-managed pod.
+`cloud-event-proxy` delivers the event from the Kubernetes infrastructure to Cloud-Native Network Functions (CNFs) with low latency.
+
+image:darkcircle-3.png[20,20] Event is published::
+The `cloud-event-proxy` sidecar in the PTP Operator-managed pod processes the event and publishes the event by using the PTP events REST API v2.
+
+image:darkcircle-4.png[20,20] Consumer application requests a subscription and receives the subscribed event::
+The consumer application sends an API request to the producer `cloud-event-proxy` sidecar to create a PTP events subscription.
+Once subscribed, the consumer application listens to the address specified in the resource qualifier and receives and processes the PTP events.
diff --git a/modules/cnf-about-ptp-fast-event-notifications-framework.adoc b/modules/cnf-about-ptp-fast-event-notifications-framework.adoc
index faaabba8fd..1d8c4fc48c 100644
--- a/modules/cnf-about-ptp-fast-event-notifications-framework.adoc
+++ b/modules/cnf-about-ptp-fast-event-notifications-framework.adoc
@@ -1,45 +1,17 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: CONCEPT
-[id="cnf-about-ptp-fast-event-notifications-framework_{context}"]
+[id="cnf-about-ptp-fast-event-notifications-framework-{ptp-events-rest-api}_{context}"]
 = About the PTP fast event notifications framework
 
-Use the Precision Time Protocol (PTP) fast event notifications framework to subscribe cluster applications to PTP events that the bare-metal cluster node generates.
+Use the Precision Time Protocol (PTP) fast event REST API v2 to subscribe cluster applications to PTP events that the bare-metal cluster node generates.
 
 [NOTE]
 ====
-The fast events notifications framework uses a REST API for communication. The REST API is based on the _O-RAN O-Cloud Notification API Specification for Event Consumers 3.0_ that is available from link:https://orandownloadsweb.azurewebsites.net/specifications[O-RAN ALLIANCE Specifications].
+The fast events notifications framework uses a REST API for communication. The PTP events REST API v1 and v2 are based on the _O-RAN O-Cloud Notification API Specification for Event Consumers 3.0_ that is available from link:https://orandownloadsweb.azurewebsites.net/specifications[O-RAN ALLIANCE Specifications].
+
+Only the PTP events REST API v2 is O-RAN v3 compliant.
 ====
-
-The framework consists of a publisher, subscriber, and an HTTP messaging protocol to handle communications between the publisher and subscriber applications.
-Applications run the `cloud-event-proxy` container in a sidecar pattern to subscribe to PTP events.
-The `cloud-event-proxy` sidecar container can access the same resources as the primary application container without using any of the resources of the primary application and with no significant latency.
-
-.Overview of PTP fast events
-image::319_OpenShift_PTP_bare-metal_OCP_nodes_0323_4.13.png[Overview of PTP fast events]
-
-image:darkcircle-1.png[20,20] Event is generated on the cluster host::
-`linuxptp-daemon` in the PTP Operator-managed pod runs as a Kubernetes `DaemonSet` and manages the various `linuxptp` processes (`ptp4l`, `phc2sys`, and optionally for grandmaster clocks, `ts2phc`).
-The `linuxptp-daemon` passes the event to the UNIX domain socket.
-
-image:darkcircle-2.png[20,20] Event is passed to the cloud-event-proxy sidecar::
-The PTP plugin reads the event from the UNIX domain socket and passes it to the `cloud-event-proxy` sidecar in the PTP Operator-managed pod.
-`cloud-event-proxy` delivers the event from the Kubernetes infrastructure to Cloud-Native Network Functions (CNFs) with low latency.
-
-image:darkcircle-3.png[20,20] Event is persisted::
-The `cloud-event-proxy` sidecar in the PTP Operator-managed pod processes the event and publishes the cloud-native event by using a REST API.
-
-image:darkcircle-4.png[20,20] Message is transported::
-The message transporter transports the event to the `cloud-event-proxy` sidecar in the application pod over HTTP.
-
-image:darkcircle-5.png[20,20] Event is available from the REST API::
-The `cloud-event-proxy` sidecar in the Application pod processes the event and makes it available by using the REST API.
-
-image:darkcircle-6.png[20,20] Consumer application requests a subscription and receives the subscribed event::
-The consumer application sends an API request to the `cloud-event-proxy` sidecar in the application pod to create a PTP events subscription.
-The `cloud-event-proxy` sidecar creates an HTTP messaging listener protocol for the resource specified in the subscription.
-
-The `cloud-event-proxy` sidecar in the application pod receives the event from the PTP Operator-managed pod, unwraps the cloud events object to retrieve the data, and posts the event to the consumer application.
-The consumer application listens to the address specified in the resource qualifier and receives and processes the PTP event.
diff --git a/modules/cnf-configuring-the-ptp-fast-event-publisher.adoc b/modules/cnf-configuring-the-ptp-fast-event-publisher.adoc
index cae32c376a..35be5e1d50 100644
--- a/modules/cnf-configuring-the-ptp-fast-event-publisher.adoc
+++ b/modules/cnf-configuring-the-ptp-fast-event-publisher.adoc
@@ -1,9 +1,10 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: PROCEDURE
-[id="cnf-configuring-the-ptp-fast-event-publisher_{context}"]
+[id="cnf-configuring-the-ptp-fast-event-publisher-{ptp-events-rest-api}_{context}"]
 = Configuring the PTP fast event notifications publisher
 
 To start using PTP fast event notifications for a network interface in your cluster, you must enable the fast event publisher in the PTP Operator `PtpOperatorConfig` custom resource (CR) and configure `ptpClockThreshold` values in a `PtpConfig` CR that you create.
@@ -22,21 +23,12 @@ To start using PTP fast event notifications for a network interface in your clus
 
 .. Save the following YAML in the `ptp-operatorconfig.yaml` file:
 +
-[source,yaml]
-----
-apiVersion: ptp.openshift.io/v1
-kind: PtpOperatorConfig
-metadata:
-  name: default
-  namespace: openshift-ptp
-spec:
-  daemonNodeSelector:
-    node-role.kubernetes.io/worker: ""
-  ptpEventConfig:
-    enableEventPublisher: true <1>
-----
-<1> Set `enableEventPublisher` to `true` to enable PTP fast event notifications.
-
+ifeval::["{ptp-events-rest-api}" == "v1"]
+include::snippets/ptp-event-config-api-v1.adoc[]
+endif::[]
+ifeval::["{ptp-events-rest-api}" == "v2"]
+include::snippets/ptp-event-config-api-v2.adoc[]
+endif::[]
 +
 [NOTE]
 ====
diff --git a/modules/cnf-fast-event-notifications-api-reference-v2.adoc b/modules/cnf-fast-event-notifications-api-reference-v2.adoc
new file mode 100644
index 0000000000..10663c471a
--- /dev/null
+++ b/modules/cnf-fast-event-notifications-api-reference-v2.adoc
@@ -0,0 +1,484 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-events-rest-api-reference-v2.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="cnf-fast-event-notifications-v2-api-refererence_{context}"]
+= PTP events REST API v2 endpoints
+
+[id="api-ocloud-notifications-v2-subscriptions_{context}"]
+== api/ocloudNotifications/v2/subscriptions
+
+[discrete]
+=== HTTP method
+
+`GET api/ocloudNotifications/v2/subscriptions`
+
+[discrete]
+=== Description
+
+Returns a list of subscriptions. If subscriptions exist, a `200 OK` status code is returned along with the list of subscriptions.
+
+.Example API response
+[source,json]
+----
+[
+ {
+  "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/os-clock-sync-state",
+  "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+  "SubscriptionId": "ccedbf08-3f96-4839-a0b6-2eb0401855ed",
+  "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/ccedbf08-3f96-4839-a0b6-2eb0401855ed"
+ },
+ {
+  "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/clock-class",
+  "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+  "SubscriptionId": "a939a656-1b7d-4071-8cf1-f99af6e931f2",
+  "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/a939a656-1b7d-4071-8cf1-f99af6e931f2"
+ },
+ {
+  "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
+  "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+  "SubscriptionId": "ba4564a3-4d9e-46c5-b118-591d3105473c",
+  "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/ba4564a3-4d9e-46c5-b118-591d3105473c"
+ },
+ {
+  "ResourceAddress": "/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",
+  "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+  "SubscriptionId": "ea0d772e-f00a-4889-98be-51635559b4fb",
+  "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/ea0d772e-f00a-4889-98be-51635559b4fb"
+ },
+ {
+  "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+  "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+  "SubscriptionId": "762999bf-b4a0-4bad-abe8-66e646b65754",
+  "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/762999bf-b4a0-4bad-abe8-66e646b65754"
+ }
+]
+----
+
+[discrete]
+=== HTTP method
+
+`POST api/ocloudNotifications/v2/subscriptions`
+
+[discrete]
+=== Description
+
+Creates a new subscription for the required event by passing the appropriate payload.
+If a subscription is successfully created, or if it already exists, a `201 Created` status code is returned.
+You can subscribe to the following PTP events:
+
+* `sync-state` events
+* `lock-state` events
+* `gnss-sync-status events` events
+* `os-clock-sync-state` events
+* `clock-class` events
+
+.Query parameters
+[cols=2*, width="60%", options="header"]
+|====
+|Parameter
+|Type
+
+|subscription
+|data
+|====
+
+.Example sync-state subscription payload
+[source,json]
+----
+{
+"EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+"ResourceAddress": "/cluster/node/{node_name}/sync/sync-status/sync-state"
+}
+----
+
+.Example PTP lock-state events subscription payload
+[source,json]
+----
+{
+"EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+"ResourceAddress": "/cluster/node/{node_name}/sync/ptp-status/lock-state"
+}
+----
+
+.Example PTP gnss-sync-status events subscription payload
+[source,json]
+----
+{
+"EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+"ResourceAddress": "/cluster/node/{node_name}/sync/gnss-status/gnss-sync-status"
+}
+----
+
+.Example PTP os-clock-sync-state events subscription payload
+[source,json]
+----
+{
+"EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+"ResourceAddress": "/cluster/node/{node_name}/sync/sync-status/os-clock-sync-state"
+}
+----
+
+.Example PTP clock-class events subscription payload
+[source,json]
+----
+{
+"EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+"ResourceAddress": "/cluster/node/{node_name}/sync/ptp-status/clock-class"
+}
+----
+
+.Example API response
+[source,json]
+----
+{
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
+    "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+    "SubscriptionId": "620283f3-26cd-4a6d-b80a-bdc4b614a96a",
+    "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/620283f3-26cd-4a6d-b80a-bdc4b614a96a"
+}
+----
+
+[discrete]
+=== HTTP method
+
+`DELETE api/ocloudNotifications/v2/subscriptions`
+
+[discrete]
+=== Description
+
+Deletes all subscriptions.
+
+.Example API response
+[source,json]
+----
+{
+"status": "deleted all subscriptions"
+}
+----
+
+[id="api-ocloud-notifications-v2-subscriptions-subscription_id_{context}"]
+== api/ocloudNotifications/v2/subscriptions/{subscription_id}
+
+[discrete]
+=== HTTP method
+
+`GET api/ocloudNotifications/v2/subscriptions/{subscription_id}`
+
+[discrete]
+=== Description
+
+Returns details for the subscription with ID `subscription_id`.
+
+.Global path parameters
+[cols=2*, width="60%", options="header"]
+|====
+|Parameter
+|Type
+
+|`subscription_id`
+|string
+|====
+
+.Example API response
+[source,json]
+----
+{
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
+    "EndpointUri": "http://consumer-events-subscription-service.cloud-events.svc.cluster.local:9043/event",
+    "SubscriptionId": "620283f3-26cd-4a6d-b80a-bdc4b614a96a",
+    "UriLocation": "http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions/620283f3-26cd-4a6d-b80a-bdc4b614a96a"
+}
+----
+
+[discrete]
+=== HTTP method
+
+`DELETE api/ocloudNotifications/v2/subscriptions/{subscription_id}`
+
+[discrete]
+=== Description
+
+Deletes the subscription with ID `subscription_id`.
+
+.Global path parameters
+[cols=2*, width="60%", options="header"]
+|====
+|Parameter
+|Type
+
+|`subscription_id`
+|string
+|====
+
+.HTTP response codes
+[cols=2*, width="60%", options="header"]
+|====
+|HTTP response
+|Description
+
+|204 No Content
+|Success
+|====
+
+[id="api-ocloudnotifications-v2-health_{context}"]
+== api/ocloudNotifications/v2/health
+
+[discrete]
+=== HTTP method
+
+`GET api/ocloudNotifications/v2/health/`
+
+[discrete]
+=== Description
+
+Returns the health status for the `ocloudNotifications` REST API.
+
+.HTTP response codes
+[cols=2*, width="60%", options="header"]
+|====
+|HTTP response
+|Description
+
+|200 OK
+|Success
+|====
+
+[id="api-ocloudnotifications-v2-publishers_{context}"]
+== api/ocloudNotifications/v2/publishers
+
+[discrete]
+=== HTTP method
+
+`GET api/ocloudNotifications/v2/publishers`
+
+[discrete]
+=== Description
+
+Returns a list of publisher details for the cluster node.
+The system generates notifications when the relevant equipment state changes.
+
+You can use equipment synchronization status subscriptions together to deliver a detailed view of the overall synchronization health of the system.
+
+.Example API response
+[source,json]
+----
+[
+  {
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+    "EndpointUri": "http://localhost:9043/api/ocloudNotifications/v2/dummy",
+    "SubscriptionId": "4ea72bfa-185c-4703-9694-cdd0434cd570",
+    "UriLocation": "http://localhost:9043/api/ocloudNotifications/v2/publishers/4ea72bfa-185c-4703-9694-cdd0434cd570"
+  },
+  {
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/os-clock-sync-state",
+    "EndpointUri": "http://localhost:9043/api/ocloudNotifications/v2/dummy",
+    "SubscriptionId": "71fbb38e-a65d-41fc-823b-d76407901087",
+    "UriLocation": "http://localhost:9043/api/ocloudNotifications/v2/publishers/71fbb38e-a65d-41fc-823b-d76407901087"
+  },
+  {
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/clock-class",
+    "EndpointUri": "http://localhost:9043/api/ocloudNotifications/v2/dummy",
+    "SubscriptionId": "7bc27cad-03f4-44a9-8060-a029566e7926",
+    "UriLocation": "http://localhost:9043/api/ocloudNotifications/v2/publishers/7bc27cad-03f4-44a9-8060-a029566e7926"
+  },
+  {
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
+    "EndpointUri": "http://localhost:9043/api/ocloudNotifications/v2/dummy",
+    "SubscriptionId": "6e7b6736-f359-46b9-991c-fbaed25eb554",
+    "UriLocation": "http://localhost:9043/api/ocloudNotifications/v2/publishers/6e7b6736-f359-46b9-991c-fbaed25eb554"
+  },
+  {
+    "ResourceAddress": "/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",
+    "EndpointUri": "http://localhost:9043/api/ocloudNotifications/v2/dummy",
+    "SubscriptionId": "31bb0a45-7892-45d4-91dd-13035b13ed18",
+    "UriLocation": "http://localhost:9043/api/ocloudNotifications/v2/publishers/31bb0a45-7892-45d4-91dd-13035b13ed18"
+  }
+]
+----
+
+.HTTP response codes
+[cols=2*, width="60%", options="header"]
+|====
+|HTTP response
+|Description
+
+|200 OK
+|Success
+|====
+
+[id="resource-address-current-state-v2_{context}"]
+== api/ocloudNotifications/v2/{resource_address}/CurrentState
+
+[discrete]
+=== HTTP method
+
+`GET api/ocloudNotifications/v2/cluster/node/{node_name}/sync/ptp-status/lock-state/CurrentState`
+
+`GET api/ocloudNotifications/v2/cluster/node/{node_name}/sync/sync-status/os-clock-sync-state/CurrentState`
+
+`GET api/ocloudNotifications/v2/cluster/node/{node_name}/sync/ptp-status/clock-class/CurrentState`
+
+`GET api/ocloudNotifications/v2/cluster/node/{node_name}/sync/sync-status/sync-state/CurrentState`
+
+`GET api/ocloudNotifications/v2/cluster/node/{node_name}/sync/gnss-status/gnss-sync-state/CurrentState`
+
+[discrete]
+=== Description
+
+Returns the current state of the `os-clock-sync-state`, `clock-class`, `lock-state`, `gnss-sync-status`, or `sync-state` events for the cluster node.
+
+* `os-clock-sync-state` notifications describe the host operating system clock synchronization state. Can be in `LOCKED` or `FREERUN` state.
+* `clock-class` notifications describe the current state of the PTP clock class.
+* `lock-state` notifications describe the current status of the PTP equipment lock state. Can be in `LOCKED`, `HOLDOVER` or `FREERUN` state.
+* `sync-state` notifications describe the current status of the least synchronized of the PTP clock `lock-state` and
+`os-clock-sync-state` states.
+* `gnss-sync-status` notifications describe the GNSS clock synchronization state.
+
+.Global path parameters
+[cols=2*, width="60%", options="header"]
+|====
+|Parameter
+|Type
+
+|`resource_address`
+|string
+|====
+
+.Example lock-state API response
+[source,json]
+----
+{
+  "id": "c1ac3aa5-1195-4786-84f8-da0ea4462921",
+  "type": "event.sync.ptp-status.ptp-state-change",
+  "source": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
+  "dataContentType": "application/json",
+  "time": "2023-01-10T02:41:57.094981478Z",
+  "data": {
+    "version": "1.0",
+    "values": [
+      {
+        "ResourceAddress": "/cluster/node/compute-1.example.com/ens5fx/master",
+        "dataType": "notification",
+        "valueType": "enumeration",
+        "value": "LOCKED"
+      },
+      {
+        "ResourceAddress": "/cluster/node/compute-1.example.com/ens5fx/master",
+        "dataType": "metric",
+        "valueType": "decimal64.3",
+        "value": "29"
+      }
+    ]
+  }
+}
+----
+
+.Example os-clock-sync-state API response
+[source,json]
+----
+{
+  "specversion": "0.3",
+  "id": "4f51fe99-feaa-4e66-9112-66c5c9b9afcb",
+  "source": "/cluster/node/compute-1.example.com/sync/sync-status/os-clock-sync-state",
+  "type": "event.sync.sync-status.os-clock-sync-state-change",
+  "subject": "/cluster/node/compute-1.example.com/sync/sync-status/os-clock-sync-state",
+  "datacontenttype": "application/json",
+  "time": "2022-11-29T17:44:22.202Z",
+  "data": {
+    "version": "1.0",
+    "values": [
+      {
+        "ResourceAddress": "/cluster/node/compute-1.example.com/CLOCK_REALTIME",
+        "dataType": "notification",
+        "valueType": "enumeration",
+        "value": "LOCKED"
+      },
+      {
+        "ResourceAddress": "/cluster/node/compute-1.example.com/CLOCK_REALTIME",
+        "dataType": "metric",
+        "valueType": "decimal64.3",
+        "value": "27"
+      }
+    ]
+  }
+}
+----
+
+.Example clock-class API response
+[source,json]
+----
+{
+  "id": "064c9e67-5ad4-4afb-98ff-189c6aa9c205",
+  "type": "event.sync.ptp-status.ptp-clock-class-change",
+  "source": "/cluster/node/compute-1.example.com/sync/ptp-status/clock-class",
+  "dataContentType": "application/json",
+  "time": "2023-01-10T02:41:56.785673989Z",
+  "data": {
+    "version": "1.0",
+    "values": [
+      {
+        "ResourceAddress": "/cluster/node/compute-1.example.com/ens5fx/master",
+        "dataType": "metric",
+        "valueType": "decimal64.3",
+        "value": "165"
+      }
+    ]
+  }
+}
+----
+
+.Example sync-state API response
+[source,json]
+----
+{
+    "specversion": "0.3",
+    "id": "8c9d6ecb-ae9f-4106-82c4-0a778a79838d",
+    "source": "/sync/sync-status/sync-state",
+    "type": "event.sync.sync-status.synchronization-state-change",
+    "subject": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+    "datacontenttype": "application/json",
+    "time": "2024-08-28T14:50:57.327585316Z",
+    "data":
+    {
+        "version": "1.0",
+        "values": [
+        {
+            "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+            "data_type": "notification",
+            "value_type": "enumeration",
+            "value": "LOCKED"
+        }]
+    }
+}
+----
+
+.Example gnss-sync-state API response
+[source,json]
+----
+{
+  "id": "435e1f2a-6854-4555-8520-767325c087d7",
+  "type": "event.sync.gnss-status.gnss-state-change",
+  "source": "/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",
+  "dataContentType": "application/json",
+  "time": "2023-09-27T19:35:33.42347206Z",
+  "data": {
+    "version": "1.0",
+    "values": [
+      {
+        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
+        "dataType": "notification",
+        "valueType": "enumeration",
+        "value": "LOCKED"
+      },
+      {
+        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
+        "dataType": "metric",
+        "valueType": "decimal64.3",
+        "value": "5"
+      }
+    ]
+  }
+}
+----
diff --git a/modules/cnf-fast-event-notifications-api-refererence.adoc b/modules/cnf-fast-event-notifications-api-reference.adoc
similarity index 67%
rename from modules/cnf-fast-event-notifications-api-refererence.adoc
rename to modules/cnf-fast-event-notifications-api-reference.adoc
index ed331a1ae3..cf1d3054cc 100644
--- a/modules/cnf-fast-event-notifications-api-refererence.adoc
+++ b/modules/cnf-fast-event-notifications-api-reference.adoc
@@ -1,12 +1,10 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/ptp-events-rest-api-reference.adoc
 
 :_mod-docs-content-type: PROCEDURE
 [id="cnf-fast-event-notifications-api-refererence_{context}"]
-= PTP events REST API reference
-
-Use the PTP event notifications REST API to subscribe a cluster application to the PTP events that are generated on the parent node.
+= PTP events REST API v1 endpoints
 
 [id="api-ocloud-notifications-v1-subscriptions_{context}"]
 == api/ocloudNotifications/v1/subscriptions
@@ -42,7 +40,15 @@ Returns a list of subscriptions. If subscriptions exist, a `200 OK` status code
 [discrete]
 === Description
 
-Creates a new subscription. If a subscription is successfully created, or if it already exists, a `201 Created` status code is returned.
+Creates a new subscription for the required event by passing the appropriate payload.
+If a subscription is successfully created, or if it already exists, a `201 Created` status code is returned.
+You can subscribe to the following PTP events:
+
+* `lock-state` events
+* `os-clock-sync-state` events
+* `clock-class` events
+* `gnss-sync-status` events
+* `sync-state` events
 
 .Query parameters
 [cols=2*, width="60%", options="header"]
@@ -54,7 +60,7 @@ Creates a new subscription. If a subscription is successfully created, or if it
 |data
 |====
 
-.Example payload
+.Example PTP events subscription payload
 [source,json]
 ----
 {
@@ -63,6 +69,51 @@ Creates a new subscription. If a subscription is successfully created, or if it
 }
 ----
 
+.Example PTP lock-state events subscription payload
+[source,json]
+----
+{
+"endpointUri": "http://localhost:8989/event",
+"resource": "/cluster/node/{node_name}/sync/ptp-status/lock-state"
+}
+----
+
+.Example PTP os-clock-sync-state events subscription payload
+[source,json]
+----
+{
+"endpointUri": "http://localhost:8989/event",
+"resource": "/cluster/node/{node_name}/sync/sync-status/os-clock-sync-state"
+}
+----
+
+.Example PTP clock-class events subscription payload
+[source,json]
+----
+{
+"endpointUri": "http://localhost:8989/event",
+"resource": "/cluster/node/{node_name}/sync/ptp-status/clock-class"
+}
+----
+
+.Example PTP gnss-sync-status events subscription payload
+[source,json]
+----
+{
+"endpointUri": "http://localhost:8989/event",
+"resource": "/cluster/node/{node_name}/sync/gnss-status/gnss-sync-status"
+}
+----
+
+.Example sync-state subscription payload
+[source,json]
+----
+{
+"endpointUri": "http://localhost:8989/event",
+"resource": "/cluster/node/{node_name}/sync/sync-status/sync-state"
+}
+----
+
 [discrete]
 === HTTP method
 
@@ -165,6 +216,12 @@ OK
 [id="api-ocloudnotifications-v1-publishers_{context}"]
 == api/ocloudNotifications/v1/publishers
 
+[IMPORTANT]
+====
+The `api/ocloudNotifications/v1/publishers` endpoint is only available from the cloud-event-proxy container in the PTP Operator managed pod.
+It is not available for consumer applications in the application pod.
+====
+
 [discrete]
 === HTTP method
 
@@ -173,14 +230,9 @@ OK
 [discrete]
 === Description
 
-Returns an array of `os-clock-sync-state`, `ptp-clock-class-change`, `lock-state`, and `gnss-sync-status` details for the cluster node.
+Returns a list of publisher details for the cluster node.
 The system generates notifications when the relevant equipment state changes.
 
-* `os-clock-sync-state` notifications describe the host operating system clock synchronization state. Can be in `LOCKED` or `FREERUN` state.
-* `ptp-clock-class-change` notifications describe the current state of the PTP clock class.
-* `lock-state` notifications describe the current status of the PTP equipment lock state. Can be in `LOCKED`, `HOLDOVER` or `FREERUN` state.
-* `gnss-sync-status` notifications describe the GPS synchronization state with regard to the external GNSS clock signal. Can be in `LOCKED` or `FREERUN` state.
-
 You can use equipment synchronization status subscriptions together to deliver a detailed view of the overall synchronization health of the system.
 
 .Example API response
@@ -197,7 +249,7 @@ You can use equipment synchronization status subscriptions together to deliver a
     "id": "28cd82df-8436-4f50-bbd9-7a9742828a71",
     "endpointUri": "http://localhost:9085/api/ocloudNotifications/v1/dummy",
     "uriLocation": "http://localhost:9085/api/ocloudNotifications/v1/publishers/28cd82df-8436-4f50-bbd9-7a9742828a71",
-    "resource": "/cluster/node/compute-1.example.com/sync/ptp-status/ptp-clock-class-change"
+    "resource": "/cluster/node/compute-1.example.com/sync/ptp-status/clock-class"
   },
   {
     "id": "44aa480d-7347-48b0-a5b0-e0af01fa9677",
@@ -214,143 +266,33 @@ You can use equipment synchronization status subscriptions together to deliver a
 ]
 ----
 
-You can find `os-clock-sync-state`, `ptp-clock-class-change`, `lock-state`, and `gnss-sync-status` events in the logs for the `cloud-event-proxy` container. For example:
-
-[source,terminal]
-----
-$ oc logs -f linuxptp-daemon-cvgr6 -n openshift-ptp -c cloud-event-proxy
-----
-
-.Example os-clock-sync-state event
-[source,json]
-----
-{
-   "id":"c8a784d1-5f4a-4c16-9a81-a3b4313affe5",
-   "type":"event.sync.sync-status.os-clock-sync-state-change",
-   "source":"/cluster/compute-1.example.com/ptp/CLOCK_REALTIME",
-   "dataContentType":"application/json",
-   "time":"2022-05-06T15:31:23.906277159Z",
-   "data":{
-      "version":"v1",
-      "values":[
-         {
-            "resource":"/sync/sync-status/os-clock-sync-state",
-            "dataType":"notification",
-            "valueType":"enumeration",
-            "value":"LOCKED"
-         },
-         {
-            "resource":"/sync/sync-status/os-clock-sync-state",
-            "dataType":"metric",
-            "valueType":"decimal64.3",
-            "value":"-53"
-         }
-      ]
-   }
-}
-----
-
-.Example ptp-clock-class-change event
-[source,json]
-----
-{
-   "id":"69eddb52-1650-4e56-b325-86d44688d02b",
-   "type":"event.sync.ptp-status.ptp-clock-class-change",
-   "source":"/cluster/compute-1.example.com/ptp/ens2fx/master",
-   "dataContentType":"application/json",
-   "time":"2022-05-06T15:31:23.147100033Z",
-   "data":{
-      "version":"v1",
-      "values":[
-         {
-            "resource":"/sync/ptp-status/ptp-clock-class-change",
-            "dataType":"metric",
-            "valueType":"decimal64.3",
-            "value":"135"
-         }
-      ]
-   }
-}
-----
-
-.Example lock-state event
-[source,json]
-----
-{
-   "id":"305ec18b-1472-47b3-aadd-8f37933249a9",
-   "type":"event.sync.ptp-status.ptp-state-change",
-   "source":"/cluster/compute-1.example.com/ptp/ens2fx/master",
-   "dataContentType":"application/json",
-   "time":"2022-05-06T15:31:23.467684081Z",
-   "data":{
-      "version":"v1",
-      "values":[
-         {
-            "resource":"/sync/ptp-status/lock-state",
-            "dataType":"notification",
-            "valueType":"enumeration",
-            "value":"LOCKED"
-         },
-         {
-            "resource":"/sync/ptp-status/lock-state",
-            "dataType":"metric",
-            "valueType":"decimal64.3",
-            "value":"62"
-         }
-      ]
-   }
-}
-----
-
-.Example gnss-sync-status event
-[source,json]
-----
-{
-  "id": "435e1f2a-6854-4555-8520-767325c087d7",
-  "type": "event.sync.gnss-status.gnss-state-change",
-  "source": "/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",
-  "dataContentType": "application/json",
-  "time": "2023-09-27T19:35:33.42347206Z",
-  "data": {
-    "version": "v1",
-    "values": [
-      {
-        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
-        "dataType": "notification",
-        "valueType": "enumeration",
-        "value": "LOCKED"
-      },
-      {
-        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
-        "dataType": "metric",
-        "valueType": "decimal64.3",
-        "value": "5"
-      }
-    ]
-  }
-}
-----
-
 [id="resource-address-current-state_{context}"]
 == api/ocloudNotifications/v1/{resource_address}/CurrentState
 
 [discrete]
 === HTTP method
 
-`GET api/ocloudNotifications/v1/cluster/node/<node_name>/sync/ptp-status/lock-state/CurrentState`
+`GET api/ocloudNotifications/v1/cluster/node/{node_name}/sync/ptp-status/lock-state/CurrentState`
 
-`GET api/ocloudNotifications/v1/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state/CurrentState`
+`GET api/ocloudNotifications/v1/cluster/node/{node_name}/sync/sync-status/os-clock-sync-state/CurrentState`
 
-`GET api/ocloudNotifications/v1/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change/CurrentState`
+`GET api/ocloudNotifications/v1/cluster/node/{node_name}/sync/ptp-status/clock-class/CurrentState`
+
+`GET api/ocloudNotifications/v1/cluster/node/{node_name}/sync/sync-status/sync-state/CurrentState`
+
+`GET api/ocloudNotifications/v1/cluster/node/{node_name}/sync/gnss-status/gnss-sync-state/CurrentState`
 
 [discrete]
 === Description
 
-Configure the `CurrentState` API endpoint to return the current state of the `os-clock-sync-state`, `ptp-clock-class-change`, `lock-state` events for the cluster node.
+Returns the current state of the `os-clock-sync-state`, `clock-class`, `lock-state`, `gnss-sync-status`, or `sync-state` events for the cluster node.
 
 * `os-clock-sync-state` notifications describe the host operating system clock synchronization state. Can be in `LOCKED` or `FREERUN` state.
-* `ptp-clock-class-change` notifications describe the current state of the PTP clock class.
+* `clock-class` notifications describe the current state of the PTP clock class.
 * `lock-state` notifications describe the current status of the PTP equipment lock state. Can be in `LOCKED`, `HOLDOVER` or `FREERUN` state.
+* `sync-state` notifications describe the current status of the least synchronized of the `ptp-status/lock-state` and
+`sync-status/os-clock-sync-state` endpoints.
+* `gnss-sync-status` notifications describe the GNSS clock synchronization state.
 
 .Global path parameters
 [cols=2*, width="60%", options="header"]
@@ -372,7 +314,7 @@ Configure the `CurrentState` API endpoint to return the current state of the `os
   "dataContentType": "application/json",
   "time": "2023-01-10T02:41:57.094981478Z",
   "data": {
-    "version": "v1",
+    "version": "1.0",
     "values": [
       {
         "resource": "/cluster/node/compute-1.example.com/ens5fx/master",
@@ -403,7 +345,7 @@ Configure the `CurrentState` API endpoint to return the current state of the `os
   "datacontenttype": "application/json",
   "time": "2022-11-29T17:44:22.202Z",
   "data": {
-    "version": "v1",
+    "version": "1.0",
     "values": [
       {
         "resource": "/cluster/node/compute-1.example.com/CLOCK_REALTIME",
@@ -422,17 +364,17 @@ Configure the `CurrentState` API endpoint to return the current state of the `os
 }
 ----
 
-.Example ptp-clock-class-change API response
+.Example clock-class API response
 [source,json]
 ----
 {
   "id": "064c9e67-5ad4-4afb-98ff-189c6aa9c205",
   "type": "event.sync.ptp-status.ptp-clock-class-change",
-  "source": "/cluster/node/compute-1.example.com/sync/ptp-status/ptp-clock-class-change",
+  "source": "/cluster/node/compute-1.example.com/sync/ptp-status/clock-class",
   "dataContentType": "application/json",
   "time": "2023-01-10T02:41:56.785673989Z",
   "data": {
-    "version": "v1",
+    "version": "1.0",
     "values": [
       {
         "resource": "/cluster/node/compute-1.example.com/ens5fx/master",
@@ -444,3 +386,57 @@ Configure the `CurrentState` API endpoint to return the current state of the `os
   }
 }
 ----
+
+.Example sync-state API response
+[source,json]
+----
+{
+    "specversion": "0.3",
+    "id": "8c9d6ecb-ae9f-4106-82c4-0a778a79838d",
+    "source": "/sync/sync-status/sync-state",
+    "type": "event.sync.sync-status.synchronization-state-change",
+    "subject": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+    "datacontenttype": "application/json",
+    "time": "2024-08-28T14:50:57.327585316Z",
+    "data":
+    {
+        "version": "1.0",
+        "values": [
+        {
+            "ResourceAddress": "/cluster/node/compute-1.example.com/sync/sync-status/sync-state",
+            "data_type": "notification",
+            "value_type": "enumeration",
+            "value": "LOCKED"
+        }]
+    }
+}
+----
+
+.Example gnss-sync-status API response
+[source,json]
+----
+{
+  "id": "435e1f2a-6854-4555-8520-767325c087d7",
+  "type": "event.sync.gnss-status.gnss-state-change",
+  "source": "/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",
+  "dataContentType": "application/json",
+  "time": "2023-09-27T19:35:33.42347206Z",
+  "data": {
+    "version": "1.0",
+    "values": [
+      {
+        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
+        "dataType": "notification",
+        "valueType": "enumeration",
+        "value": "LOCKED"
+      },
+      {
+        "resource": "/cluster/node/compute-1.example.com/ens2fx/master",
+        "dataType": "metric",
+        "valueType": "decimal64.3",
+        "value": "5"
+      }
+    ]
+  }
+}
+----
diff --git a/modules/cnf-migrating-from-amqp-to-http-transport.adoc b/modules/cnf-migrating-from-amqp-to-http-transport.adoc
index 20d4d45770..a72edb88ba 100644
--- a/modules/cnf-migrating-from-amqp-to-http-transport.adoc
+++ b/modules/cnf-migrating-from-amqp-to-http-transport.adoc
@@ -9,6 +9,7 @@
 
 If you have previously deployed PTP or bare-metal events consumer applications, you need to update the applications to use HTTP message transport.
 
+
 .Prerequisites
 
 * You have installed the OpenShift CLI (`oc`).
diff --git a/modules/cnf-monitoring-fast-events-metrics.adoc b/modules/cnf-monitoring-fast-events-metrics.adoc
index 71ab3d7355..fdb8db9cce 100644
--- a/modules/cnf-monitoring-fast-events-metrics.adoc
+++ b/modules/cnf-monitoring-fast-events-metrics.adoc
@@ -1,9 +1,10 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: PROCEDURE
-[id="cnf-monitoring-fast-events-metrics_{context}"]
+[id="cnf-monitoring-fast-events-metrics-{ptp-events-rest-api}_{context}"]
 = Monitoring PTP fast event metrics
 
 You can monitor PTP fast events metrics from cluster nodes where the `linuxptp-daemon` is running.
@@ -34,15 +35,25 @@ sh-4.4# curl http://localhost:9091/metrics
 ----
 +
 .Example output
+[source,terminal]
 ----
 # HELP cne_api_events_published Metric to get number of events published by the rest api
 # TYPE cne_api_events_published gauge
 cne_api_events_published{address="/cluster/node/compute-1.example.com/sync/gnss-status/gnss-sync-status",status="success"} 1
 cne_api_events_published{address="/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",status="success"} 94
-cne_api_events_published{address="/cluster/node/compute-1.example.com/sync/ptp-status/ptp-clock-class-change",status="success"} 18
+cne_api_events_published{address="/cluster/node/compute-1.example.com/sync/ptp-status/class-change",status="success"} 18
 cne_api_events_published{address="/cluster/node/compute-1.example.com/sync/sync-status/os-clock-sync-state",status="success"} 27
 ----
 
+. Optional.
+You can also find PTP events in the logs for the `cloud-event-proxy` container.
+For example, run the following command:
++
+[source,terminal]
+----
+$ oc logs -f linuxptp-daemon-cvgr6 -n openshift-ptp -c cloud-event-proxy
+----
+
 . To view the PTP event in the {product-title} web console, copy the name of the PTP metric you want to query, for example, `openshift_ptp_offset_ns`.
 
 . In the {product-title} web console, click *Observe* -> *Metrics*.
diff --git a/modules/nw-ptp-operator-metrics-reference.adoc b/modules/nw-ptp-operator-metrics-reference.adoc
index b67e63d949..22c6eefa15 100644
--- a/modules/nw-ptp-operator-metrics-reference.adoc
+++ b/modules/nw-ptp-operator-metrics-reference.adoc
@@ -1,9 +1,10 @@
 // Module included in the following assemblies:
 //
-// * networking/ptp/using-ptp-events.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: REFERENCE
-[id="nw-ptp-operator-metrics-reference_{context}"]
+[id="nw-ptp-operator-metrics-reference-{ptp-events-rest-api}_{context}"]
 = PTP fast event metrics reference
 
 The following table describes the PTP fast events metrics that are available from cluster nodes where the `linuxptp-daemon` service is running.
@@ -112,5 +113,3 @@ Possible values are 0 (`NOFIX`), 1 (`DEAD RECKONING ONLY`), 2 (`2D-FIX`), 3 (`3D
 |`{from="gnss",iface="ens2fx",node="compute-1.example.com",process="gnss"} 3`
 
 |====
-
-
diff --git a/modules/ptp-cloud-event-proxy-sidecar-api.adoc b/modules/ptp-cloud-event-proxy-sidecar-api.adoc
deleted file mode 100644
index 21cb5f9899..0000000000
--- a/modules/ptp-cloud-event-proxy-sidecar-api.adoc
+++ /dev/null
@@ -1,18 +0,0 @@
-// Module included in the following assemblies:
-//
-// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
-
-:_mod-docs-content-type: REFERENCE
-[id="ptp-cloud-event-proxy-sidecar-api_{context}"]
-= PTP events available from the cloud-event-proxy sidecar REST API
-
-PTP events consumer applications can poll the PTP events producer for the following PTP timing events.
-
-.PTP events available from the cloud-event-proxy sidecar
-[options="header"]
-|====
-|Resource URI|Description
-|`/cluster/node/<node_name>/sync/ptp-status/lock-state`| Describes the current status of the PTP equipment lock state. Can be in `LOCKED`, `HOLDOVER`, or `FREERUN` state.
-|`/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state`| Describes the host operating system clock synchronization state. Can be in `LOCKED` or `FREERUN` state.
-|`/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change`| Describes the current state of the PTP clock class.
-|====
diff --git a/modules/ptp-events-consumer-application-v2.adoc b/modules/ptp-events-consumer-application-v2.adoc
new file mode 100644
index 0000000000..3288fa9ca1
--- /dev/null
+++ b/modules/ptp-events-consumer-application-v2.adoc
@@ -0,0 +1,108 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="ptp-events-consumer-application-v2_{context}"]
+= PTP events REST API v2 consumer application reference
+
+PTP event consumer applications require the following features:
+
+. A web service running with a `POST` handler to receive the cloud native PTP events JSON payload
+. A `createSubscription` function to subscribe to the PTP events producer
+. A `getCurrentState` function to poll the current state of the PTP events producer
+
+The following example Go snippets illustrate these requirements:
+
+.Example PTP events consumer server function in Go
+[source,go]
+----
+func server() {
+  http.HandleFunc("/event", getEvent)
+  http.ListenAndServe(":9043", nil)
+}
+
+func getEvent(w http.ResponseWriter, req *http.Request) {
+  defer req.Body.Close()
+  bodyBytes, err := io.ReadAll(req.Body)
+  if err != nil {
+    log.Errorf("error reading event %v", err)
+  }
+  e := string(bodyBytes)
+  if e != "" {
+    processEvent(bodyBytes)
+    log.Infof("received event %s", string(bodyBytes))
+  } else {
+    w.WriteHeader(http.StatusNoContent)
+  }
+}
+----
+
+.Example PTP events createSubscription function in Go
+[source,go,subs="attributes+"]
+----
+import (
+"github.com/redhat-cne/sdk-go/pkg/pubsub"
+"github.com/redhat-cne/sdk-go/pkg/types"
+v1pubsub "github.com/redhat-cne/sdk-go/v1/pubsub"
+)
+
+// Subscribe to PTP events using v2 REST API
+s1,_:=createsubscription("/cluster/node/<node_name>/sync/sync-status/sync-state")
+s2,_:=createsubscription("/cluster/node/<node_name>/sync/ptp-status/lock-state")
+s3,_:=createsubscription("/cluster/node/<node_name>/sync/gnss-status/gnss-sync-status")
+s4,_:=createsubscription("/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state")
+s5,_:=createsubscription("/cluster/node/<node_name>/sync/ptp-status/clock-class")
+
+// Create PTP event subscriptions POST
+func createSubscription(resourceAddress string) (sub pubsub.PubSub, err error) {
+  var status int
+  apiPath := "/api/ocloudNotifications/v2/"
+  localAPIAddr := "localhost:8989" // vDU service API address
+  apiAddr := "ptp-event-publisher-service-<node_name>.openshift-ptp.svc.cluster.local:9043" // <1>
+  apiVersion := "2.0"
+
+  subURL := &types.URI{URL: url.URL{Scheme: "http",
+    Host: apiAddr
+    Path: fmt.Sprintf("%s%s", apiPath, "subscriptions")}}
+  endpointURL := &types.URI{URL: url.URL{Scheme: "http",
+    Host: localAPIAddr,
+    Path: "event"}}
+
+  sub = v1pubsub.NewPubSub(endpointURL, resourceAddress, apiVersion)
+  var subB []byte
+
+  if subB, err = json.Marshal(&sub); err == nil {
+    rc := restclient.New()
+    if status, subB = rc.PostWithReturn(subURL, subB); status != http.StatusCreated {
+      err = fmt.Errorf("error in subscription creation api at %s, returned status %d", subURL, status)
+    } else {
+      err = json.Unmarshal(subB, &sub)
+    }
+  } else {
+    err = fmt.Errorf("failed to marshal subscription for %s", resourceAddress)
+  }
+  return
+}
+----
+<1> Replace `<node_name>` with the FQDN of the node that is generating the PTP events. For example, `compute-1.example.com`.
+
+.Example PTP events consumer getCurrentState function in Go
+[source,go,subs="attributes+"]
+----
+//Get PTP event state for the resource
+func getCurrentState(resource string) {
+  //Create publisher
+  url := &types.URI{URL: url.URL{Scheme: "http",
+    Host: "ptp-event-publisher-service-<node_name>.openshift-ptp.svc.cluster.local:9043", // <1>
+    Path: fmt.SPrintf("/api/ocloudNotifications/v2/%s/CurrentState",resource}}
+  rc := restclient.New()
+  status, event := rc.Get(url)
+  if status != http.StatusOK {
+    log.Errorf("CurrentState:error %d from url %s, %s", status, url.String(), event)
+  } else {
+    log.Debugf("Got CurrentState: %s ", event)
+  }
+}
+----
+<1> Replace `<node_name>` with the FQDN of the node that is generating the PTP events. For example, `compute-1.example.com`.
diff --git a/modules/ptp-events-consumer-application.adoc b/modules/ptp-events-consumer-application.adoc
index e8886a4ba4..43c0a8a216 100644
--- a/modules/ptp-events-consumer-application.adoc
+++ b/modules/ptp-events-consumer-application.adoc
@@ -3,7 +3,7 @@
 // * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: REFERENCE
-[id="ptp-events-consumer-application_{context}"]
+[id="ptp-events-consumer-application-{ptp-events-rest-api}_{context}"]
 = PTP events consumer application reference
 
 PTP event consumer applications require the following features:
@@ -39,7 +39,7 @@ func getEvent(w http.ResponseWriter, req *http.Request) {
 ----
 
 .Example PTP events createSubscription function in Go
-[source,go]
+[source,go,subs="attributes+"]
 ----
 import (
 "github.com/redhat-cne/sdk-go/pkg/pubsub"
@@ -49,13 +49,13 @@ v1pubsub "github.com/redhat-cne/sdk-go/v1/pubsub"
 
 // Subscribe to PTP events using REST API
 s1,_:=createsubscription("/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state") <1>
-s2,_:=createsubscription("/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change")
+s2,_:=createsubscription("/cluster/node/<node_name>/sync/ptp-status/class-change")
 s3,_:=createsubscription("/cluster/node/<node_name>/sync/ptp-status/lock-state")
 
 // Create PTP event subscriptions POST
 func createSubscription(resourceAddress string) (sub pubsub.PubSub, err error) {
   var status int
-      apiPath:= "/api/ocloudNotifications/v1/"
+      apiPath:= "/api/ocloudNotifications/{ptp-events-rest-api}/"
       localAPIAddr:=localhost:8989 // vDU service API address
       apiAddr:= "localhost:8089" // event framework API address
 
@@ -85,14 +85,14 @@ func createSubscription(resourceAddress string) (sub pubsub.PubSub, err error) {
 <1> Replace `<node_name>` with the FQDN of the node that is generating the PTP events. For example, `compute-1.example.com`.
 
 .Example PTP events consumer getCurrentState function in Go
-[source,go]
+[source,go,subs="attributes+"]
 ----
 //Get PTP event state for the resource
 func getCurrentState(resource string) {
   //Create publisher
   url := &types.URI{URL: url.URL{Scheme: "http",
     Host: localhost:8989,
-    Path: fmt.SPrintf("/api/ocloudNotifications/v1/%s/CurrentState",resource}}
+    Path: fmt.SPrintf("/api/ocloudNotifications/{ptp-events-rest-api}/%s/CurrentState",resource}}
   rc := restclient.New()
   status, event := rc.Get(url)
   if status != http.StatusOK {
diff --git a/modules/ptp-getting-the-current-ptp-clock-status.adoc b/modules/ptp-getting-the-current-ptp-clock-status.adoc
deleted file mode 100644
index dedcdbd928..0000000000
--- a/modules/ptp-getting-the-current-ptp-clock-status.adoc
+++ /dev/null
@@ -1,46 +0,0 @@
-// Module included in the following assemblies:
-//
-// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
-
-:_mod-docs-content-type: REFERENCE
-[id="ptp-getting-the-current-ptp-clock-status_{context}"]
-= Getting the current PTP clock status
-
-To get the current PTP status for the node, send a `GET` action to one of the following event REST APIs:
-
-* `+http://localhost:8081/api/ocloudNotifications/v1/cluster/node/<node_name>/sync/ptp-status/lock-state/CurrentState+`
-
-* `+http://localhost:8081/api/ocloudNotifications/v1/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state/CurrentState+`
-
-* `+http://localhost:8081/api/ocloudNotifications/v1/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change/CurrentState+`
-
-The response is a cloud native event JSON object. For example:
-
-.Example lock-state API response
-[source,json]
-----
-{
-  "id": "c1ac3aa5-1195-4786-84f8-da0ea4462921",
-  "type": "event.sync.ptp-status.ptp-state-change",
-  "source": "/cluster/node/compute-1.example.com/sync/ptp-status/lock-state",
-  "dataContentType": "application/json",
-  "time": "2023-01-10T02:41:57.094981478Z",
-  "data": {
-    "version": "v1",
-    "values": [
-      {
-        "resource": "/cluster/node/compute-1.example.com/ens5fx/master",
-        "dataType": "notification",
-        "valueType": "enumeration",
-        "value": "LOCKED"
-      },
-      {
-        "resource": "/cluster/node/compute-1.example.com/ens5fx/master",
-        "dataType": "metric",
-        "valueType": "decimal64.3",
-        "value": "29"
-      }
-    ]
-  }
-}
-----
diff --git a/modules/ptp-reference-deployment-and-service-crs-v2.adoc b/modules/ptp-reference-deployment-and-service-crs-v2.adoc
new file mode 100644
index 0000000000..7e582037bb
--- /dev/null
+++ b/modules/ptp-reference-deployment-and-service-crs-v2.adoc
@@ -0,0 +1,108 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="ptp-reference-deployment-and-service-crs-v2_{context}"]
+= Reference event consumer deployment and service CRs using PTP events REST API v2
+
+Use the following example PTP event consumer custom resources (CRs) as a reference when deploying your PTP events consumer application for use with the PTP events REST API v2.
+
+.Reference cloud event consumer namespace
+[source,yaml]
+----
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: cloud-events
+  labels:
+    security.openshift.io/scc.podSecurityLabelSync: "false"
+    pod-security.kubernetes.io/audit: "privileged"
+    pod-security.kubernetes.io/enforce: "privileged"
+    pod-security.kubernetes.io/warn: "privileged"
+    name: cloud-events
+    openshift.io/cluster-monitoring: "true"
+  annotations:
+    workload.openshift.io/allowed: management
+----
+
+.Reference cloud event consumer deployment
+[source,yaml]
+----
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: cloud-consumer-deployment
+  namespace: cloud-events
+  labels:
+    app: consumer
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: consumer
+  template:
+    metadata:
+      annotations:
+        target.workload.openshift.io/management: '{"effect": "PreferredDuringScheduling"}'
+      labels:
+        app: consumer
+    spec:
+      nodeSelector:
+        node-role.kubernetes.io/worker: ""
+      serviceAccountName: consumer-sa
+      containers:
+        - name: cloud-event-consumer
+          image: cloud-event-consumer
+          imagePullPolicy: Always
+          args:
+            - "--local-api-addr=consumer-events-subscription-service.cloud-events.svc.cluster.local:9043"
+            - "--api-path=/api/ocloudNotifications/v2/"
+            - "--api-addr=127.0.0.1:8089"
+            - "--api-version=2.0"
+            - "--http-event-publishers=ptp-event-publisher-service-NODE_NAME.openshift-ptp.svc.cluster.local:9043"
+          env:
+            - name: NODE_NAME
+              valueFrom:
+                fieldRef:
+                  fieldPath: spec.nodeName
+            - name: CONSUMER_TYPE
+              value: "PTP"
+            - name: ENABLE_STATUS_CHECK
+              value: "true"
+      volumes:
+        - name: pubsubstore
+          emptyDir: {}
+----
+
+.Reference cloud event consumer service account
+[source,yaml]
+----
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: consumer-sa
+  namespace: cloud-events
+----
+
+.Reference cloud event consumer service
+[source,yaml]
+----
+apiVersion: v1
+kind: Service
+metadata:
+  annotations:
+    prometheus.io/scrape: "true"
+  name: consumer-events-subscription-service
+  namespace: cloud-events
+  labels:
+    app: consumer-service
+spec:
+  ports:
+    - name: sub-port
+      port: 9043
+  selector:
+    app: consumer
+  sessionAffinity: None
+  type: ClusterIP
+----
diff --git a/modules/ptp-reference-deployment-and-service-crs.adoc b/modules/ptp-reference-deployment-and-service-crs.adoc
index 1f4b7d14f8..c71e5b1576 100644
--- a/modules/ptp-reference-deployment-and-service-crs.adoc
+++ b/modules/ptp-reference-deployment-and-service-crs.adoc
@@ -3,7 +3,7 @@
 // * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: REFERENCE
-[id="ptp-reference-deployment-and-service-crs_{context}"]
+[id="ptp-reference-deployment-and-service-crs-{ptp-events-rest-api}_{context}"]
 = Reference cloud-event-proxy deployment and service CRs
 
 Use the following example `cloud-event-proxy` deployment and subscriber service CRs as a reference when deploying your PTP events consumer application.
diff --git a/modules/ptp-subscribing-consumer-app-to-events.adoc b/modules/ptp-subscribing-consumer-app-to-events.adoc
index cc2dfce734..53651e434b 100644
--- a/modules/ptp-subscribing-consumer-app-to-events.adoc
+++ b/modules/ptp-subscribing-consumer-app-to-events.adoc
@@ -1,81 +1,32 @@
 // Module included in the following assemblies:
 //
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
 // * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: REFERENCE
-[id="ptp-subscribing-consumer-app-to-events_{context}"]
-= Subscribing the consumer application to PTP events
+[id="ptp-subscribing-consumer-app-to-events-{ptp-events-rest-api}_{context}"]
+= Subscribing to PTP events with the REST API {ptp-events-rest-api}
 
-Before the PTP events consumer application can poll for events, you need to subscribe the application to the event producer.
+ifeval::["{ptp-events-rest-api}" == "v2"]
+Deploy your `cloud-event-consumer` application container and subscribe the `cloud-event-consumer` application to PTP events posted by the `cloud-event-proxy` container in the pod managed by the PTP Operator.
 
-[id="ptp-sub-lock-state-events_{context}"]
-== Subscribing to PTP lock-state events
+Subscribe consumer applications to PTP events by sending a `POST` request to `\http://ptp-event-publisher-service-NODE_NAME.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/subscriptions` passing the appropriate subscription request payload.
 
-To create a subscription for PTP `lock-state` events, send a `POST` action to the cloud event API at `+http://localhost:8081/api/ocloudNotifications/v1/subscriptions+` with the following payload:
+[NOTE]
+====
+`9043` is the default port for the `cloud-event-proxy` container deployed in the PTP event producer pod.
+You can configure a different port for your application as required.
+====
+endif::[]
 
-[source,json]
-----
-{
-"endpointUri": "http://localhost:8989/event",
-"resource": "/cluster/node/<node_name>/sync/ptp-status/lock-state",
-}
-----
+ifeval::["{ptp-events-rest-api}" == "v1"]
+Deploy your `cloud-event-consumer` application container and `cloud-event-proxy` sidecar container in a separate application pod.
 
-.Example response
-[source,json]
-----
-{
-"id": "e23473d9-ba18-4f78-946e-401a0caeff90",
-"endpointUri": "http://localhost:8989/event",
-"uriLocation": "http://localhost:8089/api/ocloudNotifications/v1/subscriptions/e23473d9-ba18-4f78-946e-401a0caeff90",
-"resource": "/cluster/node/<node_name>/sync/ptp-status/lock-state",
-}
-----
+Subscribe the `cloud-event-consumer` application to PTP events posted by the `cloud-event-proxy` container at `\http://localhost:8089/api/ocloudNotifications/v1/` in the application pod.
 
-[id="ptp-sub-os-clock-sync-state_{context}"]
-== Subscribing to PTP os-clock-sync-state events
-
-To create a subscription for PTP `os-clock-sync-state` events, send a `POST` action to the cloud event API at `+http://localhost:8081/api/ocloudNotifications/v1/subscriptions+` with the following payload:
-
-[source,json]
-----
-{
-"endpointUri": "http://localhost:8989/event",
-"resource": "/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state",
-}
-----
-
-.Example response
-[source,json]
-----
-{
-"id": "e23473d9-ba18-4f78-946e-401a0caeff90",
-"endpointUri": "http://localhost:8989/event",
-"uriLocation": "http://localhost:8089/api/ocloudNotifications/v1/subscriptions/e23473d9-ba18-4f78-946e-401a0caeff90",
-"resource": "/cluster/node/<node_name>/sync/sync-status/os-clock-sync-state",
-}
-----
-
-[id="ptp-sub-ptp-clock-class-change_{context}"]
-== Subscribing to PTP ptp-clock-class-change events
-
-To create a subscription for PTP `ptp-clock-class-change` events, send a `POST` action to the cloud event API at `+http://localhost:8081/api/ocloudNotifications/v1/subscriptions+` with the following payload:
-
-[source,json]
-----
-{
-"endpointUri": "http://localhost:8989/event",
-"resource": "/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change",
-}
-----
-
-.Example response
-[source,json]
-----
-{
-"id": "e23473d9-ba18-4f78-946e-401a0caeff90",
-"endpointUri": "http://localhost:8989/event",
-"uriLocation": "http://localhost:8089/api/ocloudNotifications/v1/subscriptions/e23473d9-ba18-4f78-946e-401a0caeff90",
-"resource": "/cluster/node/<node_name>/sync/ptp-status/ptp-clock-class-change",
-}
-----
+[NOTE]
+====
+`9089` is the default port for the `cloud-event-consumer` container deployed in the application pod.
+You can configure a different port for your application as required.
+====
+endif::[]
diff --git a/modules/ptp-verifying-events-consumer-app-is-receiving-events-v2.adoc b/modules/ptp-verifying-events-consumer-app-is-receiving-events-v2.adoc
new file mode 100644
index 0000000000..df2fed2218
--- /dev/null
+++ b/modules/ptp-verifying-events-consumer-app-is-receiving-events-v2.adoc
@@ -0,0 +1,82 @@
+// Module included in the following assemblies:
+//
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
+// * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="ptp-verifying-events-consumer-app-is-receiving-events-v2_{context}"]
+= Verifying that the PTP events REST API v2 consumer application is receiving events
+
+Verify that the `cloud-event-consumer` container in the application pod is receiving Precision Time Protocol (PTP) events.
+
+.Prerequisites
+
+* You have installed the OpenShift CLI (`oc`).
+
+* You have logged in as a user with `cluster-admin` privileges.
+
+* You have installed and configured the PTP Operator.
+
+* You have deployed a cloud events application pod and PTP events consumer application.
+
+.Procedure
+
+. Check the logs for the deployed events consumer application.
+For example, run the following command:
++
+[source,terminal]
+----
+$ oc -n cloud-events logs -f deployment/cloud-consumer-deployment
+----
++
+.Example output
+[source,terminal]
+----
+time = "2024-09-02T13:49:01Z"
+level = info msg = "transport host path is set to  ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043"
+time = "2024-09-02T13:49:01Z"
+level = info msg = "apiVersion=2.0, updated apiAddr=ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043, apiPath=/api/ocloudNotifications/v2/"
+time = "2024-09-02T13:49:01Z"
+level = info msg = "Starting local API listening to :9043"
+time = "2024-09-02T13:49:06Z"
+level = info msg = "transport host path is set to  ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043"
+time = "2024-09-02T13:49:06Z"
+level = info msg = "checking for rest service health"
+time = "2024-09-02T13:49:06Z"
+level = info msg = "health check http://ptp-event-publisher-service-compute-1.openshift-ptp.svc.cluster.local:9043/api/ocloudNotifications/v2/health"
+time = "2024-09-02T13:49:07Z"
+level = info msg = "rest service returned healthy status"
+time = "2024-09-02T13:49:07Z"
+level = info msg = "healthy publisher; subscribing to events"
+time = "2024-09-02T13:49:07Z"
+level = info msg = "received event {\"specversion\":\"1.0\",\"id\":\"ab423275-f65d-4760-97af-5b0b846605e4\",\"source\":\"/sync/ptp-status/clock-class\",\"type\":\"event.sync.ptp-status.ptp-clock-class-change\",\"time\":\"2024-09-02T13:49:07.226494483Z\",\"data\":{\"version\":\"1.0\",\"values\":[{\"ResourceAddress\":\"/cluster/node/compute-1.example.com/ptp-not-set\",\"data_type\":\"metric\",\"value_type\":\"decimal64.3\",\"value\":\"0\"}]}}"
+----
+
+. Optional. Test the REST API by using `oc` and port-forwarding port `9043` from the `linuxptp-daemon` deployment.
+For example, run the following command:
++
+[source,terminal]
+----
+$ oc port-forward -n openshift-ptp ds/linuxptp-daemon 9043:9043
+----
++
+.Example output
+[source,terminal]
+----
+Forwarding from 127.0.0.1:9043 -> 9043
+Forwarding from [::1]:9043 -> 9043
+Handling connection for 9043
+----
++
+Open a new shell prompt and test the REST API v2 endpoints:
++
+[source,terminal]
+----
+$ curl -X GET http://localhost:9043/api/ocloudNotifications/v2/health
+----
++
+.Example output
+[source,terminal]
+----
+OK
+----
diff --git a/modules/ptp-verifying-events-consumer-app-is-receiving-events.adoc b/modules/ptp-verifying-events-consumer-app-is-receiving-events.adoc
index 8e339a6875..9fc6709de2 100644
--- a/modules/ptp-verifying-events-consumer-app-is-receiving-events.adoc
+++ b/modules/ptp-verifying-events-consumer-app-is-receiving-events.adoc
@@ -3,8 +3,8 @@
 // * networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
 
 :_mod-docs-content-type: PROCEDURE
-[id="ptp-verifying-events-consumer-app-is-receiving-events_{context}"]
-= Verifying that the PTP events consumer application is receiving events
+[id="ptp-verifying-events-consumer-app-is-receiving-events-{ptp-events-rest-api}_{context}"]
+= Verifying that the PTP events REST API v1 consumer application is receiving events
 
 Verify that the `cloud-event-proxy` container in the application pod is receiving PTP events.
 
diff --git a/networking/ptp/about-ptp.adoc b/networking/ptp/about-ptp.adoc
index 4b0f3b2a4f..d5ba4c34e6 100644
--- a/networking/ptp/about-ptp.adoc
+++ b/networking/ptp/about-ptp.adoc
@@ -36,3 +36,5 @@ include::modules/ptp-dual-nics.adoc[leveloffset=+1]
 include::modules/ptp-linuxptp-introduction.adoc[leveloffset=+1]
 
 include::modules/ptp-overview-of-gnss-grandmaster-clock.adoc[leveloffset=+1]
+
+include::modules/cnf-about-ptp-and-clock-synchronization.adoc[leveloffset=+1]
diff --git a/networking/ptp/configuring-ptp.adoc b/networking/ptp/configuring-ptp.adoc
index 8ed99078a8..a7c4ee980e 100644
--- a/networking/ptp/configuring-ptp.adoc
+++ b/networking/ptp/configuring-ptp.adoc
@@ -25,7 +25,7 @@ include::modules/nw-ptp-configuring-linuxptp-services-as-grandmaster-clock-dual-
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../networking/ptp/using-ptp-events.adoc#cnf-configuring-the-ptp-fast-event-publisher_using-ptp-hardware-fast-events-framework[Configuring the PTP fast event notifications publisher]
+* xref:../../networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
 
 include::modules/nw-ptp-grandmaster-clock-configuration-reference.adoc[leveloffset=+2]
 
@@ -44,7 +44,7 @@ include::modules/nw-ptp-configuring-linuxptp-services-as-boundary-clock.adoc[lev
 
 * xref:../../networking/ptp/configuring-ptp.adoc#cnf-configuring-fifo-priority-scheduling-for-ptp_configuring-ptp[Configuring FIFO priority scheduling for PTP hardware]
 
-* xref:../../networking/ptp/using-ptp-events.adoc#cnf-configuring-the-ptp-fast-event-publisher_using-ptp-hardware-fast-events-framework[Configuring the PTP fast event notifications publisher]
+* xref:../../networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
 
 include::modules/ptp-configuring-linuxptp-services-as-boundary-clock-dual-nic.adoc[leveloffset=+2]
 
@@ -57,7 +57,7 @@ include::modules/nw-ptp-configuring-linuxptp-services-as-ordinary-clock.adoc[lev
 
 * xref:../../networking/ptp/configuring-ptp.adoc#cnf-configuring-fifo-priority-scheduling-for-ptp_configuring-ptp[Configuring FIFO priority scheduling for PTP hardware]
 
-* xref:../../networking/ptp/using-ptp-events.adoc#cnf-configuring-the-ptp-fast-event-publisher_using-ptp-hardware-fast-events-framework[Configuring the PTP fast event notifications publisher]
+* xref:../../networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
 
 include::modules/nw-columbiaville-ptp-config-refererence.adoc[leveloffset=+2]
 
diff --git a/networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc b/networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
new file mode 100644
index 0000000000..e483b1084c
--- /dev/null
+++ b/networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc
@@ -0,0 +1,55 @@
+:_mod-docs-content-type: ASSEMBLY
+:ptp-events-rest-api: v2
+[id="ptp-cloud-events-consumer-dev-reference-{ptp-events-rest-api}"]
+= Developing PTP events consumer applications with the REST API {ptp-events-rest-api}
+include::_attributes/common-attributes.adoc[]
+:context: ptp-consumer
+
+toc::[]
+
+When developing consumer applications that make use of Precision Time Protocol (PTP) events on a bare-metal cluster node, you deploy your consumer application in a separate application pod.
+The consumer application subscribes to PTP events by using the PTP events REST API {ptp-events-rest-api}.
+
+[NOTE]
+====
+The following information provides general guidance for developing consumer applications that use PTP events.
+A complete events consumer application example is outside the scope of this information.
+====
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#ptp-events-rest-api-reference-v2[PTP events REST API v2 reference]
+
+include::modules/cnf-about-ptp-fast-event-notifications-framework.adoc[leveloffset=+1]
+
+include::modules/cnf-about-ptp-events-using-ptp-event-producer-with-o-ran-api.adoc[leveloffset=+1]
+
+include::modules/cnf-configuring-the-ptp-fast-event-publisher.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* For a complete example CR that configures `linuxptp` services as an ordinary clock with PTP fast events, see xref:../../networking/ptp/configuring-ptp.adoc#configuring-linuxptp-services-as-ordinary-clock_configuring-ptp[Configuring linuxptp services as ordinary clock].
+
+include::modules/ptp-events-consumer-application-v2.adoc[leveloffset=+1]
+
+include::modules/ptp-reference-deployment-and-service-crs-v2.adoc[leveloffset=+1]
+
+include::modules/ptp-subscribing-consumer-app-to-events.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#api-ocloud-notifications-v2-subscriptions_using-ptp-hardware-fast-events-framework-v2[api/ocloudNotifications/v2/subscriptions]
+
+include::modules/ptp-verifying-events-consumer-app-is-receiving-events-v2.adoc[leveloffset=+1]
+
+include::modules/cnf-monitoring-fast-events-metrics.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../observability/monitoring/managing-metrics.adoc#managing-metrics[Managing metrics]
+
+include::modules/nw-ptp-operator-metrics-reference.adoc[leveloffset=+1]
diff --git a/networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc b/networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
index c9ce69df03..06500d775b 100644
--- a/networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
+++ b/networking/ptp/ptp-cloud-events-consumer-dev-reference.adoc
@@ -1,16 +1,14 @@
 :_mod-docs-content-type: ASSEMBLY
-[id="ptp-cloud-events-consumer-dev-reference"]
-= Developing PTP events consumer applications
+:ptp-events-rest-api: v1
+[id="ptp-cloud-events-consumer-dev-reference-{ptp-events-rest-api}"]
+= Developing PTP events consumer applications with the REST API {ptp-events-rest-api}
 include::_attributes/common-attributes.adoc[]
 :context: ptp-consumer
 
 toc::[]
 
-When developing consumer applications that make use of Precision Time Protocol (PTP) events on a bare-metal cluster node, you need to deploy your consumer application and a `cloud-event-proxy` container in a separate application pod.
-The `cloud-event-proxy` container receives the events from the PTP Operator pod and passes it to the consumer application.
-The consumer application subscribes to the events posted in the `cloud-event-proxy` container by using a REST API.
-
-For more information about deploying PTP events applications, see xref:../../networking/ptp/using-ptp-events.adoc#cnf-about-ptp-fast-event-notifications-framework_using-ptp-hardware-fast-events-framework[About the PTP fast event notifications framework].
+When developing consumer applications that make use of Precision Time Protocol (PTP) events on a bare-metal cluster node, you deploy your consumer application in a separate application pod.
+The consumer application subscribes to PTP events by using the PTP events REST API {ptp-events-rest-api}.
 
 [NOTE]
 ====
@@ -18,14 +16,42 @@ The following information provides general guidance for developing consumer appl
 A complete events consumer application example is outside the scope of this information.
 ====
 
+include::snippets/ptp-events-rest-api-v1-deprecation.adoc[]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#ptp-events-rest-api-reference[PTP events REST API v1 reference]
+
+include::modules/cnf-about-ptp-fast-event-notifications-framework.adoc[leveloffset=+1]
+
+include::modules/cnf-about-ptp-events-consumer-sidecar-and-http-transport.adoc[leveloffset=+1]
+
+include::modules/cnf-configuring-the-ptp-fast-event-publisher.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* For a complete example CR that configures `linuxptp` services as an ordinary clock with PTP fast events, see xref:../../networking/ptp/configuring-ptp.adoc#configuring-linuxptp-services-as-ordinary-clock_configuring-ptp[Configuring linuxptp services as ordinary clock].
+
 include::modules/ptp-events-consumer-application.adoc[leveloffset=+1]
 
 include::modules/ptp-reference-deployment-and-service-crs.adoc[leveloffset=+1]
 
-include::modules/ptp-cloud-event-proxy-sidecar-api.adoc[leveloffset=+1]
-
 include::modules/ptp-subscribing-consumer-app-to-events.adoc[leveloffset=+1]
 
-include::modules/ptp-getting-the-current-ptp-clock-status.adoc[leveloffset=+1]
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#api-ocloud-notifications-v1-subscriptions_using-ptp-hardware-fast-events-framework-v1[api/ocloudNotifications/v1/subscriptions]
 
 include::modules/ptp-verifying-events-consumer-app-is-receiving-events.adoc[leveloffset=+1]
+
+include::modules/cnf-monitoring-fast-events-metrics.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../../observability/monitoring/managing-metrics.adoc#managing-metrics[Managing metrics]
+
+include::modules/nw-ptp-operator-metrics-reference.adoc[leveloffset=+1]
diff --git a/networking/ptp/ptp-events-rest-api-reference-v2.adoc b/networking/ptp/ptp-events-rest-api-reference-v2.adoc
new file mode 100644
index 0000000000..e2ba9e9b7a
--- /dev/null
+++ b/networking/ptp/ptp-events-rest-api-reference-v2.adoc
@@ -0,0 +1,29 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="ptp-events-rest-api-reference-v2"]
+= PTP events REST API v2 reference
+include::_attributes/common-attributes.adoc[]
+:context: using-ptp-hardware-fast-events-framework-v2
+
+toc::[]
+
+Use the following REST API v2 endpoints to subscribe the `cloud-event-consumer` application to Precision Time Protocol (PTP) events posted at `\http://localhost:9043/api/ocloudNotifications/v2` in the PTP events producer pod.
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#api-ocloud-notifications-v2-subscriptions_{context}[`api/ocloudNotifications/v2/subscriptions`]
+** `POST`: Creates a new subscription
+** `GET`: Retrieves a list of subscriptions
+** `DELETE`: Deletes all subscriptions
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#api-ocloud-notifications-v2-subscriptions-subscription_id_{context}[`api/ocloudNotifications/v2/subscriptions/{subscription_id}`]
+** `GET`: Returns details for the specified subscription ID
+** `DELETE`: Deletes the subscription associated with the specified subscription ID
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#api-ocloudnotifications-v2-health_{context}[`api/ocloudNotifications/v2/health`]
+** `GET`: Returns the health status of `ocloudNotifications` API
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#api-ocloudnotifications-v2-publishers_{context}[`api/ocloudNotifications/v2/publishers`]
+** `GET`: Returns a list of PTP event publishers for the cluster node
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#resource-address-current-state-v2_{context}[`api/ocloudnotifications/v2/{resource_address}/CurrentState`]
+** `GET`: Returns the current state of the event type specified by the `{resouce_address}`.
+
+include::modules/cnf-fast-event-notifications-api-reference-v2.adoc[leveloffset=+1]
diff --git a/networking/ptp/ptp-events-rest-api-reference.adoc b/networking/ptp/ptp-events-rest-api-reference.adoc
new file mode 100644
index 0000000000..638e17c15a
--- /dev/null
+++ b/networking/ptp/ptp-events-rest-api-reference.adoc
@@ -0,0 +1,33 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="ptp-events-rest-api-reference"]
+= PTP events REST API v1 reference
+include::_attributes/common-attributes.adoc[]
+:context: using-ptp-hardware-fast-events-framework-v1
+
+toc::[]
+
+Use the following Precision Time Protocol (PTP) fast event REST API v1 endpoints to subscribe the `cloud-event-consumer` application to PTP events posted by the `cloud-event-proxy` container at [x-]`http://localhost:8089/api/ocloudNotifications/v1/` in the application pod.
+
+include::snippets/ptp-events-rest-api-v1-deprecation.adoc[]
+
+The following API endpoints are available:
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#api-ocloud-notifications-v1-subscriptions_{context}[`api/ocloudNotifications/v1/subscriptions`]
+** `POST`: Creates a new subscription
+** `GET`: Retrieves a list of subscriptions
+** `DELETE`: Deletes all subscriptions
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#api-ocloud-notifications-v1-subscriptions-subscription_id_{context}[`api/ocloudNotifications/v1/subscriptions/{subscription_id}`]
+** `GET`: Returns details for the specified subscription ID
+** `DELETE`: Deletes the subscription associated with the specified subscription ID
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#api-ocloudnotifications-v1-health_{context}[`api/ocloudNotifications/v1/health`]
+** `GET`: Returns the health status of `ocloudNotifications` API
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#api-ocloudnotifications-v1-publishers_{context}[`api/ocloudNotifications/v1/publishers`]
+** `GET`: Returns a list of PTP event publishers for the cluster node
+
+* xref:../../networking/ptp/ptp-events-rest-api-reference.adoc#resource-address-current-state_{context}[`api/ocloudnotifications/v1/{resource_address}/CurrentState`]
+** `GET`: Returns the current state of one the following event types: `sync-state`, `os-clock-sync-state`, `clock-class`, `lock-state`, or `gnss-sync-status` events
+
+include::modules/cnf-fast-event-notifications-api-reference.adoc[leveloffset=+1]
diff --git a/networking/ptp/using-ptp-events.adoc b/networking/ptp/using-ptp-events.adoc
deleted file mode 100644
index 841aa270a7..0000000000
--- a/networking/ptp/using-ptp-events.adoc
+++ /dev/null
@@ -1,64 +0,0 @@
-:_mod-docs-content-type: ASSEMBLY
-[id="using-ptp-hardware-fast-events-framework"]
-= Using the PTP hardware fast event notifications framework
-include::_attributes/common-attributes.adoc[]
-:context: using-ptp-hardware-fast-events-framework
-
-toc::[]
-
-Cloud native applications such as virtual RAN (vRAN) require access to notifications about hardware timing events that are critical to the functioning of the overall network.
-Precision Time Protocol (PTP) clock synchronization errors can negatively affect the performance and reliability of your low-latency application, for example, a vRAN application running in a distributed unit (DU).
-
-include::modules/cnf-about-ptp-and-clock-synchronization.adoc[leveloffset=+1]
-
-include::modules/cnf-about-ptp-fast-event-notifications-framework.adoc[leveloffset=+1]
-
-include::modules/cnf-configuring-the-ptp-fast-event-publisher.adoc[leveloffset=+1]
-
-[role="_additional-resources"]
-.Additional resources
-
-* For a complete example CR that configures `linuxptp` services as an ordinary clock with PTP fast events, see xref:../../networking/ptp/configuring-ptp.adoc#configuring-linuxptp-services-as-ordinary-clock_configuring-ptp[Configuring linuxptp services as ordinary clock].
-
-[id="subscribing-du-applications-to-ptp-events-rest-api-reference_{context}"]
-== Subscribing DU applications to PTP events with the REST API
-
-Subscribe applications to PTP events by using the resource address `/cluster/node/<node_name>/ptp`, where `<node_name>` is the cluster node running the DU application.
-
-Deploy your `cloud-event-consumer` DU application container and `cloud-event-proxy` sidecar container in a separate DU application pod. The `cloud-event-consumer` DU application subscribes to the `cloud-event-proxy` container in the application pod.
-
-Use the following API endpoints to subscribe the `cloud-event-consumer` DU application to PTP events posted by the `cloud-event-proxy` container at [x-]`http://localhost:8089/api/ocloudNotifications/v1/` in the DU application pod:
-
-* xref:../../networking/ptp/using-ptp-events.adoc#api-ocloud-notifications-v1-subscriptions_{context}[`/api/ocloudNotifications/v1/subscriptions`]
-- `POST`: Creates a new subscription
-- `GET`: Retrieves a list of subscriptions
-- `DELETE`: Deletes all subscriptions
-
-* xref:../../networking/ptp/using-ptp-events.adoc#api-ocloud-notifications-v1-subscriptions-subscription_id_{context}[`/api/ocloudNotifications/v1/subscriptions/{subscription_id}`]
-- `GET`: Returns details for the specified subscription ID
-- `DELETE`: Deletes the subscription associated with the specified subscription ID
-
-* xref:../../networking/ptp/using-ptp-events.adoc#api-ocloudnotifications-v1-health_{context}[`/api/ocloudNotifications/v1/health`]
-- `GET`: Returns the health status of `ocloudNotifications` API
-
-* xref:../../networking/ptp/using-ptp-events.adoc#api-ocloudnotifications-v1-publishers_{context}[`api/ocloudNotifications/v1/publishers`]
-- `GET`: Returns an array of `os-clock-sync-state`, `ptp-clock-class-change`, `lock-state`, and `gnss-sync-status` messages for the cluster node
-
-* xref:../../networking/ptp/using-ptp-events.adoc#resource-address-current-state_{context}[`/api/ocloudnotifications/v1/{resource_address}/CurrentState`]
-- `GET`: Returns the current state of one the following event types: `os-clock-sync-state`, `ptp-clock-class-change`, `lock-state`, or `gnss-state-change` events
-
-[NOTE]
-====
-`9089` is the default port for the `cloud-event-consumer` container deployed in the application pod. You can configure a different port for your DU application as required.
-====
-
-include::modules/cnf-fast-event-notifications-api-refererence.adoc[leveloffset=+2]
-
-include::modules/cnf-monitoring-fast-events-metrics.adoc[leveloffset=+1]
-
-[role="_additional-resources"]
-.Additional resources
-
-* xref:../../observability/monitoring/managing-metrics.adoc#managing-metrics[Managing metrics]
-
-include::modules/nw-ptp-operator-metrics-reference.adoc[leveloffset=+1]
diff --git a/snippets/ptp-event-config-api-v1.adoc b/snippets/ptp-event-config-api-v1.adoc
new file mode 100644
index 0000000000..c7e6acdc24
--- /dev/null
+++ b/snippets/ptp-event-config-api-v1.adoc
@@ -0,0 +1,15 @@
+:_mod-docs-content-type: SNIPPET
+[source,yaml]
+----
+apiVersion: ptp.openshift.io/v1
+kind: PtpOperatorConfig
+metadata:
+  name: default
+  namespace: openshift-ptp
+spec:
+  daemonNodeSelector:
+    node-role.kubernetes.io/worker: ""
+  ptpEventConfig:
+    enableEventPublisher: true <1>
+----
+<1> Enable PTP fast event notifications by setting `enableEventPublisher` to `true`.
diff --git a/snippets/ptp-event-config-api-v2.adoc b/snippets/ptp-event-config-api-v2.adoc
new file mode 100644
index 0000000000..b377033281
--- /dev/null
+++ b/snippets/ptp-event-config-api-v2.adoc
@@ -0,0 +1,18 @@
+:_mod-docs-content-type: SNIPPET
+[source,yaml]
+----
+apiVersion: ptp.openshift.io/v1
+kind: PtpOperatorConfig
+metadata:
+  name: default
+  namespace: openshift-ptp
+spec:
+  daemonNodeSelector:
+    node-role.kubernetes.io/worker: ""
+  ptpEventConfig:
+    apiVersion: 2.0 <1>
+    enableEventPublisher: true <2>
+----
+<1> Enable the PTP events REST API v2 for the PTP event producer by setting the `ptpEventConfig.apiVersion` to 2.0.
+The default value is 1.0.
+<2> Enable PTP fast event notifications by setting `enableEventPublisher` to `true`.
diff --git a/snippets/ptp-events-rest-api-v1-deprecation.adoc b/snippets/ptp-events-rest-api-v1-deprecation.adoc
new file mode 100644
index 0000000000..0d25e662ff
--- /dev/null
+++ b/snippets/ptp-events-rest-api-v1-deprecation.adoc
@@ -0,0 +1,6 @@
+:_mod-docs-content-type: SNIPPET
+[IMPORTANT]
+====
+The PTP events REST API v1 will be deprecated in a future release.
+When developing applications that use PTP events, use the xref:../../networking/ptp/ptp-events-rest-api-reference-v2.adoc#ptp-events-rest-api-reference-v2[PTP events REST API v2].
+====