Soliditas

A matrix media proxy as cloudflare worker.

Environment variables

• HOSTNAME: the hostname, for example example.org
• SERVERNAME: the servername, for example example.org

Constructing media id

Example in TypeScript, as seen in mxcId.ts:

function toBase64Url(value: string): string {
  if (typeof btoa === 'function') {
    const bytes = new TextEncoder().encode(value);
    let binary = '';

    for (const byte of bytes) {
      binary += String.fromCodePoint(byte);
    }

    return btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replaceAll(/=+$/g, '');
  }

  if (typeof Buffer !== 'undefined') {
    return Buffer.from(value).toString('base64url');
  }

  throw new Error('No base64 encoder available in this runtime');
}

function toMatrixID(fname: string, prefix: string): string {
  const base64 = toBase64Url(fname);
  return prefix + base64;
}

You can test it against the /_soliditas/adressconvert?remoteType=[remoteType]&remoteId=[remoteID] endpoint.

Supported proxied upstreams

Giphy

You need to generate a matrix id, using the algorithm as shown above.

Example:

1. The giphy id is yXPquATCb8kGk, this has been translated using the toMatrixID function, see above, to giphy_XPquATCb8kGk.
2. mxc: mxc://example.org/giphy_XPquATCb8kGk
3. will return a redirect to https://i.giphy.com/yXPquATCb8kGk.webp

Tenor

You need to generate a matrix id, using the algorithm as shown above.

Example:

To-Do

Klipy

You need to generate a matrix id, using the algorithm as shown above.

Example:

1. The path on the klipy cdn is ffd4ac143e6335ac68951b787d3c1902/e8/3a/5LM0jRpL.gif
2. mxc: mxc://example.org/klipy_ZmZkNGFjMTQzZTYzMzVhYzY4OTUxYjc4N2QzYzE5MDIvZTgvM2EvNUxNMGpScEwuZ2lm
3. will return a redirect to https://static.klipy.com/ii/ffd4ac143e6335ac68951b787d3c1902/e8/3a/5LM0jRpL.gif

License

This project is licensed under Apache 2.0, see LICENSE.