Merge pull request #100 from ar-io/PE-5512-validity-query

fix(PE-5512): accept a validity query param that returns interactio …

src/middleware/query.ts

@@ -29,6 +29,7 @@ export const queryMiddleware = async (ctx: KoaContext, next: Next) => {
     sortKey,
     page = DEFAULT_PAGE,
     pageSize = DEFAULT_PAGE_SIZE,
+    validity,
   } = ctx.query;
 
   logger.debug('Query params provided', {
@@ -82,5 +83,10 @@ export const queryMiddleware = async (ctx: KoaContext, next: Next) => {
     ctx.state.pageSize = +pageSize;
   }
 
+  if (validity) {
+    logger.debug('Validity provided', { validity });
+    ctx.state.validity = validity === 'true' || validity === '1';
+  }
+
   return next();
 };

src/routes/contract.ts

@@ -33,6 +33,7 @@ export async function contractHandler(ctx: KoaContext) {
     warp,
     sortKey: requestedSortKey,
     blockHeight: requestedBlockHeight,
+    validity: requestedValidity,
   } = ctx.state;
   const { contractTxId } = ctx.params;
   logger.debug('Fetching contract state', {
@@ -42,6 +43,7 @@ export async function contractHandler(ctx: KoaContext) {
   });
   const {
     state,
+    validity,
     evaluationOptions,
     sortKey: evaluatedSortKey,
   } = await getContractState({
@@ -57,6 +59,7 @@ export async function contractHandler(ctx: KoaContext) {
     state,
     sortKey: evaluatedSortKey,
     evaluationOptions,
+    ...(requestedValidity && { validity }),
   };
 }
 

tests/integration/routes.test.ts

@@ -139,7 +139,7 @@ describe('Integration tests', () => {
           expect(data).to.equal('Contract is blocklisted.');
           expect(statusText).to.equal('Contract is blocklisted.');
         });
-        it('should return the contract state and id and default evaluation options', async () => {
+        it('should return the contract state and id and default evaluation options without validity', async () => {
           const { status, data } = await axios.get(`/v1/contract/${id}`);
           expect(status).to.equal(200);
           expect(data).to.not.be.undefined;
@@ -158,6 +158,29 @@ describe('Integration tests', () => {
           ]);
         });
 
+        it('should return the contract state and id and default evaluation options when validity is provided', async () => {
+          const { status, data } = await axios.get(
+            `/v1/contract/${id}?validity=true`,
+          );
+          expect(status).to.equal(200);
+          expect(data).to.not.be.undefined;
+          const { contractTxId, state, evaluationOptions, sortKey, validity } =
+            data;
+          expect(contractTxId).to.equal(id);
+          expect(evaluationOptions).not.to.be.undefined;
+          expect(sortKey).not.be.undefined;
+          expect(validity).not.to.be.undefined;
+          expect(state).to.include.keys([
+            'balances',
+            'owner',
+            'name',
+            'records',
+            'ticker',
+            'owner',
+            'controller',
+          ]);
+        });
+
         it('should return a 404 for an invalid id', async () => {
           const { status } = await axios.get(`/v1/contract/non-matching-regex`);
           expect(status).to.equal(404);