Skip to content

Commit

Permalink
Export strategies
Browse files Browse the repository at this point in the history
  • Loading branch information
gndelia committed May 31, 2024
1 parent e9123da commit e962ecc
Show file tree
Hide file tree
Showing 2 changed files with 82 additions and 79 deletions.
82 changes: 3 additions & 79 deletions packages/eth-rpc-cache/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,79 +1,3 @@
import debugConstructor from 'debug'
import pMemoize from 'promise-mem'

import { errors } from './error'
import { perBlockStrategy } from './strategies/per-block'
import { permanentStrategy } from './strategies/permanent'
import { type JsonRpcCallFn, type Strategy } from './types'
import { getKey } from './utils/cache-key'
import { clone } from './utils/clone'

const debug = debugConstructor('eth-rpc-cache')

type Options = {
allowOthers?: boolean
cache?: Map<string, unknown>
strategies?: Strategy[]
}

export const createEthRpcCache = function (
rpc: JsonRpcCallFn,
options: Options = {}
): JsonRpcCallFn {
debug('Creating EVM RPC cache')

const {
allowOthers = true,
cache = new Map(),
strategies = [perBlockStrategy, permanentStrategy]
} = options

// Each strategy resolves to a cache if it has a maxAge defined.
// Index all caches into the object by strategy name
const cachesByStrategy = strategies
.filter(({ maxAge }) => maxAge !== undefined)
.map(({ name, maxAge }) => ({
[name]: pMemoize(rpc, {
cache,
maxAge,
resolver: getKey,
...options
})
}))
.reduce((acc, curr) => ({ ...acc, ...curr }), {})

// This object indexed by method holds a function that returns which strategy (and cache)
// should be used. By default, each strategy resolves to use its own cache, but some strategies
// may resolve to other strategies' caches, depending on the method
const strategyResolver = strategies
.flatMap(({ methods, name, resolver = () => name }) =>
methods.map(method => ({
[method]: resolver
}))
)
.reduce((acc, curr) => ({ ...acc, ...curr }), {})

// Return the cached `rpc` function.
//
// If an strategy defined an RPC function for the incoming method, use that.
// Otherwise call the method directly if allowed or return proper errors.
//
// To prevent user code to mutate the cached results, the cached RPC functions
// will always return a clone of the result and not the result object itself.
return function (method, params) {
try {
const strategyName = strategyResolver[method]?.(method, params)
if (strategyName) {
return cachesByStrategy[strategyName](method, params).then(clone)
}
if (allowOthers) {
// not configured to be cached, call the method directly
return rpc(method, params)
}
return Promise.reject(errors.methodNotFound())
} catch (err) {
// @ts-expect-error error is typed as unknown by default
return Promise.reject(errors.internalServerError(err))
}
}
}
export { createEthRpcCache } from './rpc'
export { perBlockStrategy } from './strategies/per-block'
export { permanentStrategy } from './strategies/permanent'
79 changes: 79 additions & 0 deletions packages/eth-rpc-cache/src/rpc.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
import debugConstructor from 'debug'
import pMemoize from 'promise-mem'

import { errors } from './error'
import { perBlockStrategy } from './strategies/per-block'
import { permanentStrategy } from './strategies/permanent'
import { type JsonRpcCallFn, type Strategy } from './types'
import { getKey } from './utils/cache-key'
import { clone } from './utils/clone'

const debug = debugConstructor('eth-rpc-cache')

type Options = {
allowOthers?: boolean
cache?: Map<string, unknown>
strategies?: Strategy[]
}

export const createEthRpcCache = function (
rpc: JsonRpcCallFn,
options: Options = {}
): JsonRpcCallFn {
debug('Creating EVM RPC cache')

const {
allowOthers = true,
cache = new Map(),
strategies = [perBlockStrategy, permanentStrategy]
} = options

// Each strategy resolves to a cache if it has a maxAge defined.
// Index all caches into the object by strategy name
const cachesByStrategy = strategies
.filter(({ maxAge }) => maxAge !== undefined)
.map(({ name, maxAge }) => ({
[name]: pMemoize(rpc, {
cache,
maxAge,
resolver: getKey,
...options
})
}))
.reduce((acc, curr) => ({ ...acc, ...curr }), {})

// This object indexed by method holds a function that returns which strategy (and cache)
// should be used. By default, each strategy resolves to use its own cache, but some strategies
// may resolve to other strategies' caches, depending on the method
const strategyResolver = strategies
.flatMap(({ methods, name, resolver = () => name }) =>
methods.map(method => ({
[method]: resolver
}))
)
.reduce((acc, curr) => ({ ...acc, ...curr }), {})

// Return the cached `rpc` function.
//
// If an strategy defined an RPC function for the incoming method, use that.
// Otherwise call the method directly if allowed or return proper errors.
//
// To prevent user code to mutate the cached results, the cached RPC functions
// will always return a clone of the result and not the result object itself.
return function (method, params) {
try {
const strategyName = strategyResolver[method]?.(method, params)
if (strategyName) {
return cachesByStrategy[strategyName](method, params).then(clone)
}
if (allowOthers) {
// not configured to be cached, call the method directly
return rpc(method, params)
}
return Promise.reject(errors.methodNotFound())
} catch (err) {
// @ts-expect-error error is typed as unknown by default
return Promise.reject(errors.internalServerError(err))
}
}
}

0 comments on commit e962ecc

Please sign in to comment.