Base64.sol 3.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. // SPDX-License-Identifier: MIT
  2. // OpenZeppelin Contracts (last updated v4.5.0-rc.0) (utils/Base64.sol)
  3. pragma solidity ^0.8.0;
  4. /**
  5. * @dev Provides a set of functions to operate with Base64 strings.
  6. */
  7. library Base64 {
  8. /**
  9. * @dev Base64 Encoding/Decoding Table
  10. */
  11. string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
  12. /**
  13. * @dev Converts a `bytes` to its Bytes64 `string` representation.
  14. */
  15. function encode(bytes memory data) internal pure returns (string memory) {
  16. /**
  17. * Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
  18. * https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
  19. */
  20. if (data.length == 0) return "";
  21. // Loads the table into memory
  22. string memory table = _TABLE;
  23. // Encoding takes 3 bytes chunks of binary data from `bytes` data parameter
  24. // and split into 4 numbers of 6 bits.
  25. // The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up
  26. // - `data.length + 2` -> Round up
  27. // - `/ 3` -> Number of 3-bytes chunks
  28. // - `4 *` -> 4 characters for each chunk
  29. string memory result = new string(4 * ((data.length + 2) / 3));
  30. assembly {
  31. // Prepare the lookup table (skip the first "length" byte)
  32. let tablePtr := add(table, 1)
  33. // Prepare result pointer, jump over length
  34. let resultPtr := add(result, 32)
  35. // Run over the input, 3 bytes at a time
  36. for {
  37. let dataPtr := data
  38. let endPtr := add(data, mload(data))
  39. } lt(dataPtr, endPtr) {
  40. } {
  41. // Advance 3 bytes
  42. dataPtr := add(dataPtr, 3)
  43. let input := mload(dataPtr)
  44. // To write each character, shift the 3 bytes (18 bits) chunk
  45. // 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
  46. // and apply logical AND with 0x3F which is the number of
  47. // the previous character in the ASCII table prior to the Base64 Table
  48. // The result is then added to the table to get the character to write,
  49. // and finally write it in the result pointer but with a left shift
  50. // of 256 (1 byte) - 8 (1 ASCII char) = 248 bits
  51. mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
  52. resultPtr := add(resultPtr, 1) // Advance
  53. mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
  54. resultPtr := add(resultPtr, 1) // Advance
  55. mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
  56. resultPtr := add(resultPtr, 1) // Advance
  57. mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
  58. resultPtr := add(resultPtr, 1) // Advance
  59. }
  60. // When data `bytes` is not exactly 3 bytes long
  61. // it is padded with `=` characters at the end
  62. switch mod(mload(data), 3)
  63. case 1 {
  64. mstore8(sub(resultPtr, 1), 0x3d)
  65. mstore8(sub(resultPtr, 2), 0x3d)
  66. }
  67. case 2 {
  68. mstore8(sub(resultPtr, 1), 0x3d)
  69. }
  70. }
  71. return result;
  72. }
  73. }