feat(filters): support on-demand owner hashing PE-4214

In order to simplify filter construction, if owner_address is set in a
filter, but only owner is present on the matchable item (L1 TXs don't
include the address), hash owner on-demand to produce and owner_address
and match against that.

src/filters.test.ts

@@ -35,6 +35,7 @@ function getTx(id: string) {
 
 const TX_ID = '----LT69qUmuIeC4qb0MZHlxVp7UxLu_14rEkA_9n6w';
 const TX = getTx(TX_ID);
+const TX_OWNER_ADDRESS = 'Th825IP80n4i9F3Rc4cBFh767CGqiV4n7S-Oy5lGLjc';
 
 describe('AlwaysMatch', () => {
   const alwaysMatch = new AlwaysMatch();
@@ -178,12 +179,25 @@ describe('MatchAttributes', () => {
 
     const matchAttributes = new MatchAttributes(attributes);
 
-    delete TX.owner;
+    const tx = JSON.parse(JSON.stringify(TX));
+    delete tx.owner;
 
-    const result = await matchAttributes.match(TX);
+    const result = await matchAttributes.match(tx);
 
     expect(result).to.be.false;
   });
+
+  it('should match owner given an owner address', async () => {
+    const attributes = {
+      owner_address: TX_OWNER_ADDRESS,
+    };
+
+    const matchAttributes = new MatchAttributes(attributes);
+
+    const result = await matchAttributes.match(TX);
+
+    expect(result).to.be.true;
+  });
 });
 
 describe('createFilter', () => {

src/filters.ts

@@ -1,4 +1,4 @@
-import { b64UrlToUtf8 } from './lib/encoding.js';
+import { b64UrlToUtf8, fromB64Url, sha256B64Url } from './lib/encoding.js';
 import { ItemFilter, MatchableItem } from './types.js';
 
 export class AlwaysMatch implements ItemFilter {
@@ -108,6 +108,12 @@ export class MatchAttributes implements ItemFilter {
     for (const [name, value] of Object.entries(this.attributes)) {
       if (item?.[name as keyof MatchableItem] === value) {
         matches.add(name);
+      } else if (name === 'owner_address' && item['owner'] !== undefined) {
+        const ownerBuffer = fromB64Url(item['owner']);
+        const ownerAddress = sha256B64Url(ownerBuffer);
+        if (ownerAddress === value) {
+          matches.add(name);
+        }
       }
     }